🎩 You're Invited:Meet the Socket team at Black Hat in Las Vegas, August 3-6.RSVP →

@frihet/mcp-server

Advanced tools

Install Socket

Detect and block malicious and high-risk dependencies

Install

@frihet/mcp-server - npm Package Compare versions

Comparing version

1.15.2

1.15.3

+11

dist/__tests__/demo-mode.test.d.ts

		/**
		* Demo mode (`FRIHET_DEMO=1`) — DemoFrihetClient contract + fixture PII safety.
		*
		* Verifies the fixture-backed client serves stamped example data with ZERO
		* network calls, simulates writes with a demo id, labels fiscal actions as
		* simulated, and that no fixture email leaks a non-@example.com domain.
		*
		* Run: npm test (after build)
		*/
		export {};
		//# sourceMappingURL=demo-mode.test.d.ts.map

+1

dist/__tests__/demo-mode.test.d.ts.map

{"version":3,"file":"demo-mode.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/demo-mode.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG"}

+119

dist/__tests__/demo-mode.test.js

		/**
		* Demo mode (`FRIHET_DEMO=1`) — DemoFrihetClient contract + fixture PII safety.
		*
		* Verifies the fixture-backed client serves stamped example data with ZERO
		* network calls, simulates writes with a demo id, labels fiscal actions as
		* simulated, and that no fixture email leaks a non-@example.com domain.
		*
		* Run: npm test (after build)
		*/
		import { test, describe } from "node:test";
		import assert from "node:assert/strict";
		import { DemoFrihetClient } from "../demo-client.js";
		import * as fixtures from "../demo-fixtures.js";
		describe("DemoFrihetClient — reads", () => {
		test("listInvoices returns a non-empty stamped PaginatedResponse", async () => {
		const client = new DemoFrihetClient();
		const res = await client.listInvoices();
		assert.ok(Array.isArray(res.data), "data is an array");
		assert.ok(res.data.length > 0, "data is non-empty");
		assert.equal(res.total, res.data.length);
		assert.equal(res._demo, true);
		assert.ok(res._demoNotice, "_demoNotice present");
		});
		test("getInvoice(<fixture id>) returns the fixture stamped _demo:true", async () => {
		const client = new DemoFrihetClient();
		const firstId = fixtures.demoInvoices[0].id;
		const res = await client.getInvoice(firstId);
		assert.equal(res.id, firstId);
		assert.equal(res._demo, true);
		assert.ok(res._demoNotice, "_demoNotice present");
		});
		});
		describe("DemoFrihetClient — writes are simulated", () => {
		test("createInvoice returns _demo:true with a demo_-prefixed id, purely", async () => {
		const client = new DemoFrihetClient();
		const res = await client.createInvoice({
		clientName: "Test Client",
		items: [{ description: "Work", quantity: 2, unitPrice: 100 }],
		taxRate: 21,
		});
		assert.equal(res._demo, true);
		assert.equal(typeof res.id, "string");
		assert.ok(res.id.startsWith("demo_"), `id "${res.id}" starts with demo_`);
		// Echoes input + computes totals.
		assert.equal(res.clientName, "Test Client");
		assert.equal(res.subtotal, 200);
		assert.equal(res.taxAmount, 42);
		assert.equal(res.total, 242);
		// WRITE notice communicates non-persistence.
		assert.match(res._demoNotice, /Simulated — not persisted/);
		});
		test("createInvoice is a pure function — no throw, no network, repeatable", async () => {
		const client = new DemoFrihetClient();
		// Called twice back-to-back; neither throws nor hangs on a socket.
		const a = await client.createInvoice({ clientName: "A", items: [] });
		const b = await client.createInvoice({ clientName: "B", items: [] });
		assert.equal(a._demo, true);
		assert.equal(b._demo, true);
		assert.notEqual(a.id, b.id, "ids are distinct across calls");
		});
		});
		describe("DemoFrihetClient — fiscal actions are simulated only", () => {
		test("sendEInvoice returns _demo:true + a simulated queued status, never throws", async () => {
		const client = new DemoFrihetClient();
		const res = await client.sendEInvoice({ invoiceId: "demo_inv_001", format: "facturae", dispatchMode: "peppol" });
		assert.equal(res.status, "queued");
		assert.equal(typeof res.workflowRunId, "string");
		assert.equal(res._demo, true);
		const notice = res._demoNotice;
		assert.ok(notice, "_demoNotice present");
		assert.match(notice, /no submission was made to any tax authority/);
		});
		test("faceSubmit + ticketbaiSubmit are labeled simulated, never real submissions", async () => {
		const client = new DemoFrihetClient();
		const face = await client.faceSubmit({ invoiceId: "demo_inv_001", mode: "sandbox" });
		assert.equal(face.status, "submitted");
		assert.equal(face._demo, true);
		const tbai = await client.ticketbaiSubmit({ invoiceId: "demo_inv_001", sandbox: true });
		assert.equal(tbai._demo, true);
		assert.match(tbai._demoNotice, /no submission was made to any tax authority/);
		});
		});
		describe("demo fixtures — PII safety", () => {
		test("every email string in the fixtures ends with @example.com", () => {
		// Collect every string value that looks like an email across all fixture
		// exports; assert none uses a domain other than example.com.
		const emailRe = /[A-Za-z0-9._%+-]+@[A-Za-z0-9.-]+\.[A-Za-z]{2,}/g;
		const emails = [];
		const seen = new Set();
		const walk = (val) => {
		if (val == null)
		return;
		if (typeof val === "string") {
		const matches = val.match(emailRe);
		if (matches)
		emails.push(...matches);
		return;
		}
		if (typeof val !== "object")
		return;
		if (seen.has(val))
		return;
		seen.add(val);
		for (const v of Object.values(val))
		walk(v);
		};
		walk(fixtures);
		assert.ok(emails.length > 0, "fixtures contain at least one email (sanity)");
		for (const email of emails) {
		assert.ok(email.endsWith("@example.com"), `email "${email}" must be under @example.com`);
		}
		});
		test("fixtures use the ECBS/AEAT test IBAN, not a real one", () => {
		assert.equal(fixtures.DEMO_TEST_IBAN, "ES9121000418450200051332");
		const account = fixtures.demoBankAccounts[0];
		assert.equal(account.iban, fixtures.DEMO_TEST_IBAN);
		});
		});
		//# sourceMappingURL=demo-mode.test.js.map

+1

dist/__tests__/demo-mode.test.js.map

+468

dist/demo-client.d.ts

		/**
		* DemoFrihetClient — the `FRIHET_DEMO=1` seam.
		*
		* A drop-in IFrihetClient that makes ZERO network calls: it serves the canned
		* PII-safe fixtures in demo-fixtures.ts. index.ts swaps this in for FrihetClient
		* when demo mode is on, so tools (which stringify the client's return value)
		* automatically propagate the `_demo`/`_demoNotice` banner without any change
		* under src/tools/.
		*
		* Response contract (see SPEC-mcp-demo-mode.md option B/C):
		* - reads/lists → fixture data stamped `_demo:true` (READ notice).
		* - lists without fixtures → EMPTY PaginatedResponse, still stamped.
		* - writes → plausible fixture-shaped object with a `demo_`-prefixed id
		* (WRITE notice "…Simulated — not persisted.").
		* - fiscal / e-invoice / email / payroll → SIMULATED labeled response, NEVER
		* a real submission (FISCAL notice).
		* - delete / remove methods → resolve void (interface return type forbids a
		* stamp; this is the one accepted, documented gap).
		*/
		import type { IFrihetClient } from "./client-interface.js";
		import type { PaginatedResponse } from "./types.js";
		type Rec = Record<string, unknown>;
		export declare class DemoFrihetClient implements IFrihetClient {
		listInvoices(params?: {
		limit?: number;
		offset?: number;
		}): Promise<PaginatedResponse<Rec>>;
		getInvoice(id: string): Promise<Rec>;
		createInvoice(data: Rec): Promise<Rec>;
		updateInvoice(id: string, data: Rec): Promise<Rec>;
		deleteInvoice(_id: string): Promise<void>;
		searchInvoices(query: string, params?: {
		limit?: number;
		offset?: number;
		}): Promise<PaginatedResponse<Rec>>;
		listExpenses(params?: {
		limit?: number;
		offset?: number;
		}): Promise<PaginatedResponse<Rec>>;
		getExpense(id: string): Promise<Rec>;
		createExpense(data: Rec): Promise<Rec>;
		updateExpense(id: string, data: Rec): Promise<Rec>;
		deleteExpense(_id: string): Promise<void>;
		listClients(params?: {
		limit?: number;
		offset?: number;
		}): Promise<PaginatedResponse<Rec>>;
		getClient(id: string): Promise<Rec>;
		createClient(data: Rec): Promise<Rec>;
		updateClient(id: string, data: Rec): Promise<Rec>;
		deleteClient(_id: string): Promise<void>;
		listProducts(params?: {
		limit?: number;
		offset?: number;
		}): Promise<PaginatedResponse<Rec>>;
		getProduct(id: string): Promise<Rec>;
		createProduct(data: Rec): Promise<Rec>;
		updateProduct(id: string, data: Rec): Promise<Rec>;
		deleteProduct(_id: string): Promise<void>;
		listQuotes(params?: {
		limit?: number;
		offset?: number;
		}): Promise<PaginatedResponse<Rec>>;
		getQuote(id: string): Promise<Rec>;
		createQuote(data: Rec): Promise<Rec>;
		updateQuote(id: string, data: Rec): Promise<Rec>;
		deleteQuote(_id: string): Promise<void>;
		listVendors(params?: {
		limit?: number;
		offset?: number;
		}): Promise<PaginatedResponse<Rec>>;
		getVendor(id: string): Promise<Rec>;
		createVendor(data: Rec): Promise<Rec>;
		updateVendor(id: string, data: Rec): Promise<Rec>;
		deleteVendor(_id: string): Promise<void>;
		sendInvoice(id: string, to?: string): Promise<Rec>;
		markInvoicePaid(id: string, paidDate?: string): Promise<Rec>;
		getInvoicePdf(id: string): Promise<Rec>;
		getInvoiceEInvoice(invoiceId: string): Promise<Rec>;
		createCreditNote(invoiceId: string, data: {
		reason: string;
		reasonDescription?: string;
		fullCredit?: boolean;
		issueDate?: string;
		}): Promise<Rec>;
		applyLateFee(invoiceId: string, data?: {
		amount?: number;
		daysOverdue?: number;
		}): Promise<Rec>;
		sendQuote(id: string, to?: string): Promise<Rec>;
		listWebhooks(params?: {
		limit?: number;
		offset?: number;
		}): Promise<PaginatedResponse<Rec>>;
		getWebhook(id: string): Promise<Rec>;
		createWebhook(data: Rec): Promise<Rec>;
		updateWebhook(id: string, data: Rec): Promise<Rec>;
		deleteWebhook(_id: string): Promise<void>;
		listClientContacts(_clientId: string, params?: {
		limit?: number;
		offset?: number;
		}): Promise<PaginatedResponse<Rec>>;
		createClientContact(clientId: string, data: Rec): Promise<Rec>;
		deleteClientContact(_clientId: string, _contactId: string): Promise<void>;
		listClientActivities(_clientId: string, params?: {
		limit?: number;
		offset?: number;
		}): Promise<PaginatedResponse<Rec>>;
		logClientActivity(clientId: string, data: Rec): Promise<Rec>;
		listClientNotes(_clientId: string, params?: {
		limit?: number;
		offset?: number;
		}): Promise<PaginatedResponse<Rec>>;
		createClientNote(clientId: string, data: Rec): Promise<Rec>;
		deleteClientNote(_clientId: string, _noteId: string): Promise<void>;
		listDeposits(params?: {
		limit?: number;
		offset?: number;
		}): Promise<PaginatedResponse<Rec>>;
		getDeposit(id: string): Promise<Rec>;
		createDeposit(data: Rec): Promise<Rec>;
		updateDeposit(id: string, data: Rec): Promise<Rec>;
		deleteDeposit(_id: string): Promise<void>;
		applyDeposit(id: string, data?: Rec): Promise<Rec>;
		refundDeposit(id: string, data?: Rec): Promise<Rec>;
		getBusinessContext(): Promise<Rec>;
		getMonthlySummary(month?: string): Promise<Rec>;
		getQuarterlyTaxes(quarter?: string): Promise<Rec>;
		sendEInvoice(_params: {
		invoiceId: string;
		format: string;
		dispatchMode: string;
		}): Promise<{
		workflowRunId: string;
		status: "queued";
		estimatedCompletionSec: number;
		}>;
		getEInvoiceStatus(_workflowRunId: string): Promise<{
		status: "queued" \| "running" \| "succeeded" \| "failed" \| "cancelled";
		step: string;
		error?: string;
		ackId?: string;
		pdfA3Url?: string;
		xmlUrl?: string;
		}>;
		validateEInvoiceXml(_params: {
		xml: string;
		format: string;
		}): Promise<{
		valid: boolean;
		errors: Array<{
		severity: string;
		location: string;
		message: string;
		rule: string;
		}>;
		validator: "kosit" \| "mustang" \| "xsd" \| "schematron";
		durationMs: number;
		}>;
		exportDatev(params: {
		periodStart: string;
		periodEnd: string;
		format: string;
		}): Promise<{
		fileUrl: string;
		filename: string;
		rowCount: number;
		fiscalPeriod: string;
		encoding: "cp1252";
		}>;
		exportEInvoice(params: {
		invoiceId: string;
		format: string;
		signed?: boolean;
		}): Promise<{
		xmlUrl: string;
		filename: string;
		format: string;
		signed: boolean;
		}>;
		faceSubmit(params: {
		invoiceId: string;
		mode: "mock" \| "sandbox" \| "production";
		}): Promise<{
		registroFACe: string;
		status: "submitted" \| "error";
		submittedAt: string;
		mode: string;
		}>;
		faceStatus(_params: {
		invoiceId: string;
		}): Promise<{
		registroFACe: string;
		statusCode: string;
		statusDescription: string;
		rejectionReason?: string;
		}>;
		ticketbaiSubmit(params: {
		invoiceId: string;
		sandbox: boolean;
		}): Promise<{
		tbaiId: string;
		territory: "bizkaia" \| "gipuzkoa" \| "araba";
		status: "submitted" \| "accepted" \| "rejected" \| "error";
		sandbox: boolean;
		qrUrl?: string;
		}>;
		ticketbaiStatus(_params: {
		invoiceId: string;
		}): Promise<{
		tbaiId: string;
		territory: "bizkaia" \| "gipuzkoa" \| "araba";
		status: "submitted" \| "accepted" \| "rejected" \| "error";
		rejectionReason?: string;
		error?: string;
		}>;
		listReservations(params?: {
		limit?: number;
		offset?: number;
		}): Promise<PaginatedResponse<Rec>>;
		getReservation(id: string): Promise<Rec>;
		createReservation(data: Rec): Promise<Rec>;
		listProperties(params?: {
		limit?: number;
		offset?: number;
		}): Promise<PaginatedResponse<Rec>>;
		syncChannel(channelId: string, direction: "pull" \| "push" \| "both"): Promise<Rec>;
		listTerminals(params?: {
		limit?: number;
		offset?: number;
		}): Promise<PaginatedResponse<Rec>>;
		getSale(id: string): Promise<Rec>;
		listSales(params?: {
		limit?: number;
		offset?: number;
		}): Promise<PaginatedResponse<Rec>>;
		refundSale(id: string, data?: {
		amountCents?: number;
		reason?: string;
		}): Promise<Rec>;
		listKitchenTickets(params?: {
		limit?: number;
		offset?: number;
		}): Promise<PaginatedResponse<Rec>>;
		getKitchenTicket(id: string): Promise<Rec>;
		updateKitchenTicket(id: string, data: Rec): Promise<Rec>;
		listKitchenStations(params?: {
		limit?: number;
		offset?: number;
		}): Promise<PaginatedResponse<Rec>>;
		listMenuItems(params?: {
		limit?: number;
		offset?: number;
		}): Promise<PaginatedResponse<Rec>>;
		listBankAccounts(params?: {
		limit?: number;
		offset?: number;
		}): Promise<PaginatedResponse<Rec>>;
		getBankAccount(id: string): Promise<Rec>;
		listTransactions(params?: {
		limit?: number;
		offset?: number;
		}): Promise<PaginatedResponse<Rec>>;
		categorizeTransaction(id: string, data: {
		category: string;
		notes?: string;
		}): Promise<Rec>;
		matchTransactionToDocument(transactionId: string, data: {
		documentId: string;
		documentType: "invoice" \| "expense";
		notes?: string;
		}): Promise<Rec>;
		getFiscalModeloSummary(modeloCode: string, period?: string): Promise<Rec>;
		getVerifactuStatus(invoiceId: string): Promise<Rec>;
		resubmitVerifactu(invoiceId: string): Promise<Rec>;
		getTicketbaiStatus(invoiceId: string): Promise<Rec>;
		listTimeEntries(params?: {
		limit?: number;
		offset?: number;
		}): Promise<PaginatedResponse<Rec>>;
		getTimeEntry(id: string): Promise<Rec>;
		createTimeEntry(data: Rec): Promise<Rec>;
		updateTimeEntry(id: string, data: Rec): Promise<Rec>;
		deleteTimeEntry(_id: string): Promise<void>;
		getTimeSummary(params: {
		from: string;
		to: string;
		}): Promise<Rec>;
		listRecurringInvoices(params?: {
		limit?: number;
		offset?: number;
		}): Promise<PaginatedResponse<Rec>>;
		getRecurringInvoice(id: string): Promise<Rec>;
		createRecurringInvoice(data: Rec): Promise<Rec>;
		updateRecurringInvoice(id: string, data: Rec): Promise<Rec>;
		pauseRecurringInvoice(id: string): Promise<Rec>;
		resumeRecurringInvoice(id: string): Promise<Rec>;
		deleteRecurringInvoice(_id: string): Promise<void>;
		runRecurringNow(templateId: string, options?: {
		draftOnly?: boolean;
		}): Promise<Rec>;
		listTeamMembers(params?: {
		limit?: number;
		offset?: number;
		}): Promise<PaginatedResponse<Rec>>;
		inviteTeamMember(data: {
		email: string;
		role: string;
		name?: string;
		}): Promise<Rec>;
		updateTeamMemberRole(memberId: string, role: string): Promise<Rec>;
		removeTeamMember(_memberId: string): Promise<void>;
		approveGLEntry(entryId: string, notes?: string): Promise<Rec>;
		rejectGLEntry(entryId: string, reason: string): Promise<Rec>;
		getGLEntryAuditLog(entryId: string): Promise<Rec>;
		addCustomPortalDomain(data: {
		domain: string;
		workspaceId?: string;
		}): Promise<Rec>;
		verifyCustomPortalDomain(data: {
		domain: string;
		}): Promise<Rec>;
		removeCustomPortalDomain(data: {
		domain: string;
		}): Promise<Rec>;
		generatePortalOnboardLink(data: {
		email: string;
		name?: string;
		expiresInHours?: number;
		workspaceId?: string;
		}): Promise<Rec>;
		lookupTaxIdViaVIES(data: {
		vatNumber: string;
		countryCode: string;
		}): Promise<Rec>;
		getIgicModeloSummary(modeloCode: string, params?: {
		year?: string;
		period?: string;
		}): Promise<Rec>;
		calculateAiem(data: {
		ncCode: string;
		amount: number;
		description?: string;
		}): Promise<Rec>;
		getISSummary(modeloCode: string, params?: {
		year?: string;
		installment?: string;
		}): Promise<Rec>;
		listBankRules(params?: {
		limit?: number;
		offset?: number;
		}): Promise<PaginatedResponse<Rec>>;
		createBankRule(data: {
		name: string;
		conditions: Array<{
		field: string;
		operator: string;
		value: string;
		}>;
		actions: Array<{
		type: string;
		value: string;
		}>;
		isActive?: boolean;
		}): Promise<Rec>;
		sendGestoriaMessage(data: {
		workspaceId: string;
		parentType: "documentRequest" \| "filingItem" \| "obligation";
		parentId: string;
		body: string;
		}): Promise<Rec>;
		listGestoriaMessages(_params: {
		workspaceId: string;
		parentType: "documentRequest" \| "filingItem" \| "obligation";
		parentId: string;
		limit?: number;
		before?: string;
		}): Promise<{
		messages: Array<Rec>;
		hasMore: boolean;
		}>;
		createGestoriaTemplate(data: {
		name: string;
		title: string;
		description: string;
		dueDateOffsetDays: number;
		attachmentRequired?: boolean;
		variables?: Array<{
		key: string;
		label?: string;
		defaultValue?: string;
		}>;
		}): Promise<{
		templateId: string;
		}>;
		bulkSendGestoriaTemplate(data: {
		templateId: string;
		clientWorkspaceIds: string[];
		periodOverrides?: {
		quarter?: string \| number;
		year?: string \| number;
		month?: string \| number;
		};
		}): Promise<Rec>;
		getGestoriaAgingConsolidated(_params?: {
		ownerUid?: string;
		}): Promise<Rec>;
		listLeaves(params?: {
		limit?: number;
		offset?: number;
		}): Promise<PaginatedResponse<Rec>>;
		createLeaveRequest(data: {
		employeeId: string;
		type: string;
		startDate: string;
		endDate: string;
		reason?: string;
		}): Promise<Rec>;
		approveLeave(leaveId: string, data?: {
		reason?: string;
		}): Promise<Rec>;
		rejectLeave(leaveId: string, data: {
		reason: string;
		}): Promise<Rec>;
		cancelLeave(leaveId: string): Promise<Rec>;
		attendanceClockIn(data: {
		employeeId: string;
		mood?: string;
		location?: string;
		}): Promise<Rec>;
		attendanceClockOut(entryId: string): Promise<Rec>;
		getOvertimeReport(params: {
		period: string;
		employeeId?: string;
		}): Promise<Rec>;
		listAnomalies(params?: {
		limit?: number;
		offset?: number;
		}): Promise<PaginatedResponse<Rec>>;
		testWebhook(id: string, data?: {
		eventType?: string;
		}): Promise<Rec>;
		exportPayroll(params: {
		format: "a3" \| "contasol" \| "sage" \| "holded" \| "siltra";
		month: string;
		}): Promise<Rec>;
		getPayrollChecklist(params: {
		month: string;
		}): Promise<Rec>;
		getOnboardingStatus(): Promise<Rec>;
		setOnboardingPersona(data: {
		persona: "autonomo" \| "empresa" \| "agencia" \| "gestoria";
		}): Promise<Rec>;
		getPermissionsMatrix(): Promise<Rec>;
		getMyPermissions(): Promise<Rec>;
		getCurrentPeriod(params?: {
		periodId?: string;
		}): Promise<Rec>;
		closePeriod(data: {
		type: "monthly" \| "quarterly";
		}): Promise<Rec>;
		reopenPeriod(data: {
		periodId: string;
		reason: string;
		}): Promise<Rec>;
		}
		export {};
		//# sourceMappingURL=demo-client.d.ts.map

+1

dist/demo-client.d.ts.map

+554

dist/demo-client.js

		/**
		* DemoFrihetClient — the `FRIHET_DEMO=1` seam.
		*
		* A drop-in IFrihetClient that makes ZERO network calls: it serves the canned
		* PII-safe fixtures in demo-fixtures.ts. index.ts swaps this in for FrihetClient
		* when demo mode is on, so tools (which stringify the client's return value)
		* automatically propagate the `_demo`/`_demoNotice` banner without any change
		* under src/tools/.
		*
		* Response contract (see SPEC-mcp-demo-mode.md option B/C):
		* - reads/lists → fixture data stamped `_demo:true` (READ notice).
		* - lists without fixtures → EMPTY PaginatedResponse, still stamped.
		* - writes → plausible fixture-shaped object with a `demo_`-prefixed id
		* (WRITE notice "…Simulated — not persisted.").
		* - fiscal / e-invoice / email / payroll → SIMULATED labeled response, NEVER
		* a real submission (FISCAL notice).
		* - delete / remove methods → resolve void (interface return type forbids a
		* stamp; this is the one accepted, documented gap).
		*/
		import { READ_STAMP, FISCAL_STAMP, DEMO_NOW, demoPage, demoEmptyPage, findOrStub, demoId, simulateWrite, simulateAction, demoClients, demoProducts, demoInvoices, demoExpenses, demoQuotes, demoVendors, demoBankAccounts, demoTransactions, } from "./demo-fixtures.js";
		export class DemoFrihetClient {
		// ---------------------------------------------------------------- Invoices
		async listInvoices(params) {
		return demoPage(demoInvoices, params);
		}
		async getInvoice(id) {
		return findOrStub(demoInvoices, id);
		}
		async createInvoice(data) {
		const items = Array.isArray(data.items) ? data.items : [];
		const subtotal = Math.round(items.reduce((s, i) => s + (i.quantity \|\| 0) * (i.unitPrice \|\| 0), 0) * 100) / 100;
		const taxRate = typeof data.taxRate === "number" ? data.taxRate : 21;
		const taxAmount = Math.round(subtotal * (taxRate / 100) * 100) / 100;
		return simulateWrite("demo_inv", data, {
		status: data.status ?? "draft",
		subtotal,
		taxAmount,
		total: Math.round((subtotal + taxAmount) * 100) / 100,
		currency: "EUR",
		});
		}
		async updateInvoice(id, data) {
		return simulateAction(id, { ...data });
		}
		async deleteInvoice(_id) {
		return;
		}
		async searchInvoices(query, params) {
		const q = query.toLowerCase();
		const matched = demoInvoices.filter((inv) => JSON.stringify(inv).toLowerCase().includes(q));
		return demoPage(matched, params);
		}
		// ---------------------------------------------------------------- Expenses
		async listExpenses(params) {
		return demoPage(demoExpenses, params);
		}
		async getExpense(id) {
		return findOrStub(demoExpenses, id);
		}
		async createExpense(data) {
		return simulateWrite("demo_exp", data, { taxDeductible: data.taxDeductible ?? true });
		}
		async updateExpense(id, data) {
		return simulateAction(id, { ...data });
		}
		async deleteExpense(_id) {
		return;
		}
		// ---------------------------------------------------------------- Clients
		async listClients(params) {
		return demoPage(demoClients, params);
		}
		async getClient(id) {
		return findOrStub(demoClients, id);
		}
		async createClient(data) {
		return simulateWrite("demo_cli", data);
		}
		async updateClient(id, data) {
		return simulateAction(id, { ...data });
		}
		async deleteClient(_id) {
		return;
		}
		// ---------------------------------------------------------------- Products
		async listProducts(params) {
		return demoPage(demoProducts, params);
		}
		async getProduct(id) {
		return findOrStub(demoProducts, id);
		}
		async createProduct(data) {
		return simulateWrite("demo_prd", data);
		}
		async updateProduct(id, data) {
		return simulateAction(id, { ...data });
		}
		async deleteProduct(_id) {
		return;
		}
		// ---------------------------------------------------------------- Quotes
		async listQuotes(params) {
		return demoPage(demoQuotes, params);
		}
		async getQuote(id) {
		return findOrStub(demoQuotes, id);
		}
		async createQuote(data) {
		return simulateWrite("demo_quo", data, { status: data.status ?? "draft" });
		}
		async updateQuote(id, data) {
		return simulateAction(id, { ...data });
		}
		async deleteQuote(_id) {
		return;
		}
		// ---------------------------------------------------------------- Vendors
		async listVendors(params) {
		return demoPage(demoVendors, params);
		}
		async getVendor(id) {
		return findOrStub(demoVendors, id);
		}
		async createVendor(data) {
		return simulateWrite("demo_ven", data);
		}
		async updateVendor(id, data) {
		return simulateAction(id, { ...data });
		}
		async deleteVendor(_id) {
		return;
		}
		// ---------------------------------------------------------------- Invoice actions
		async sendInvoice(id, to) {
		// Email dispatch — simulated, no email is actually sent.
		return { id, status: "sent", sentAt: DEMO_NOW, ...(to ? { to } : {}), ...FISCAL_STAMP };
		}
		async markInvoicePaid(id, paidDate) {
		return simulateAction(id, { status: "paid", paidAt: paidDate ?? DEMO_NOW });
		}
		async getInvoicePdf(id) {
		return { id, url: "https://app.frihet.io/demo/invoice.pdf", contentType: "application/pdf", ...READ_STAMP };
		}
		async getInvoiceEInvoice(invoiceId) {
		return {
		xml: `<?xml version="1.0" encoding="UTF-8"?>\n<Invoice><!-- DEMO example e-invoice for ${invoiceId} --></Invoice>`,
		filename: `${invoiceId}.xml`,
		format: "facturae",
		...FISCAL_STAMP,
		};
		}
		async createCreditNote(invoiceId, data) {
		return {
		success: true,
		creditNote: {
		id: demoId("demo_cn"),
		documentNumber: "R4-DEMO-001",
		originalInvoiceId: invoiceId,
		reason: data.reason,
		fullCredit: data.fullCredit ?? true,
		},
		...FISCAL_STAMP,
		};
		}
		async applyLateFee(invoiceId, data) {
		return simulateAction(invoiceId, { lateFeeApplied: true, amount: data?.amount ?? 45.0, daysOverdue: data?.daysOverdue ?? 30 });
		}
		// ---------------------------------------------------------------- Quote actions
		async sendQuote(id, to) {
		return { id, status: "sent", sentAt: DEMO_NOW, ...(to ? { to } : {}), ...FISCAL_STAMP };
		}
		// ---------------------------------------------------------------- Webhooks
		async listWebhooks(params) {
		return demoEmptyPage(params);
		}
		async getWebhook(id) {
		return { id, ...READ_STAMP };
		}
		async createWebhook(data) {
		return simulateWrite("demo_wh", data, { active: data.active ?? true });
		}
		async updateWebhook(id, data) {
		return simulateAction(id, { ...data });
		}
		async deleteWebhook(_id) {
		return;
		}
		// ---------------------------------------------------------------- CRM: Contacts
		async listClientContacts(_clientId, params) {
		return demoEmptyPage(params);
		}
		async createClientContact(clientId, data) {
		return simulateWrite("demo_contact", data, { clientId });
		}
		async deleteClientContact(_clientId, _contactId) {
		return;
		}
		// ---------------------------------------------------------------- CRM: Activities
		async listClientActivities(_clientId, params) {
		return demoEmptyPage(params);
		}
		async logClientActivity(clientId, data) {
		return simulateWrite("demo_act", data, { clientId });
		}
		// ---------------------------------------------------------------- CRM: Notes
		async listClientNotes(_clientId, params) {
		return demoEmptyPage(params);
		}
		async createClientNote(clientId, data) {
		return simulateWrite("demo_note", data, { clientId });
		}
		async deleteClientNote(_clientId, _noteId) {
		return;
		}
		// ---------------------------------------------------------------- Deposits
		async listDeposits(params) {
		return demoEmptyPage(params);
		}
		async getDeposit(id) {
		return { id, ...READ_STAMP };
		}
		async createDeposit(data) {
		return simulateWrite("demo_dep", data, { status: data.status ?? "held" });
		}
		async updateDeposit(id, data) {
		return simulateAction(id, { ...data });
		}
		async deleteDeposit(_id) {
		return;
		}
		async applyDeposit(id, data) {
		return simulateAction(id, { ...(data ?? {}), status: "applied" });
		}
		async refundDeposit(id, data) {
		return simulateAction(id, { ...(data ?? {}), status: "refunded" });
		}
		// ---------------------------------------------------------------- Intelligence
		async getBusinessContext() {
		return {
		businessName: "Demo Studio SL",
		fiscalRegime: "autonomo",
		currency: "EUR",
		country: "ES",
		metrics: { openInvoices: 4, overdueInvoices: 1, totalClients: demoClients.length, totalProducts: demoProducts.length },
		...READ_STAMP,
		};
		}
		async getMonthlySummary(month) {
		return {
		month: month ?? "2026-07",
		revenue: 3960.4,
		expenses: 405.6,
		net: 3554.8,
		invoiceCount: 5,
		expenseCount: demoExpenses.length,
		currency: "EUR",
		...READ_STAMP,
		};
		}
		async getQuarterlyTaxes(quarter) {
		return {
		quarter: quarter ?? "2026-Q2",
		modelo303: { cuotaRepercutida: 1620.0, cuotaDeducible: 85.15, resultado: 1534.85 },
		modelo130: { rendimientoNeto: 8200.0, pagoFraccionado: 1640.0 },
		currency: "EUR",
		readonly: true,
		...READ_STAMP,
		};
		}
		// ---------------------------------------------------------------- E-Invoicing (simulated fiscal)
		async sendEInvoice(_params) {
		return { workflowRunId: demoId("demo_wf"), status: "queued", estimatedCompletionSec: 8, ...FISCAL_STAMP };
		}
		async getEInvoiceStatus(_workflowRunId) {
		return { status: "succeeded", step: "completed", ackId: "DEMO-ACK-001", ...FISCAL_STAMP };
		}
		async validateEInvoiceXml(_params) {
		return { valid: true, errors: [], validator: "xsd", durationMs: 12, ...FISCAL_STAMP };
		}
		async exportDatev(params) {
		return { fileUrl: "https://app.frihet.io/demo/datev.csv", filename: "demo-datev.csv", rowCount: 24, fiscalPeriod: `${params.periodStart}..${params.periodEnd}`, encoding: "cp1252", ...FISCAL_STAMP };
		}
		async exportEInvoice(params) {
		return { xmlUrl: "https://app.frihet.io/demo/einvoice.xml", filename: `${params.invoiceId}.xml`, format: params.format, signed: params.signed ?? false, ...FISCAL_STAMP };
		}
		async faceSubmit(params) {
		return { registroFACe: "DEMO-FACE-0001", status: "submitted", submittedAt: DEMO_NOW, mode: params.mode, ...FISCAL_STAMP };
		}
		async faceStatus(_params) {
		return { registroFACe: "DEMO-FACE-0001", statusCode: "1200", statusDescription: "Registrada (demo)", ...FISCAL_STAMP };
		}
		async ticketbaiSubmit(params) {
		return { tbaiId: "DEMO-TBAI-0001", territory: "bizkaia", status: "submitted", sandbox: params.sandbox, qrUrl: "https://app.frihet.io/demo/tbai-qr.png", ...FISCAL_STAMP };
		}
		async ticketbaiStatus(_params) {
		return { tbaiId: "DEMO-TBAI-0001", territory: "bizkaia", status: "accepted", ...FISCAL_STAMP };
		}
		// ---------------------------------------------------------------- Stay
		async listReservations(params) {
		return demoEmptyPage(params);
		}
		async getReservation(id) {
		return { id, ...READ_STAMP };
		}
		async createReservation(data) {
		return simulateWrite("demo_res", data, { status: data.status ?? "confirmed" });
		}
		async listProperties(params) {
		return demoEmptyPage(params);
		}
		async syncChannel(channelId, direction) {
		return simulateAction(channelId, { direction, synced: 0 });
		}
		// ---------------------------------------------------------------- POS
		async listTerminals(params) {
		return demoEmptyPage(params);
		}
		async getSale(id) {
		return { id, ...READ_STAMP };
		}
		async listSales(params) {
		return demoEmptyPage(params);
		}
		async refundSale(id, data) {
		return simulateAction(id, { status: "refunded", refundedAmountCents: data?.amountCents ?? 0 });
		}
		// ---------------------------------------------------------------- Kitchen
		async listKitchenTickets(params) {
		return demoEmptyPage(params);
		}
		async getKitchenTicket(id) {
		return { id, ...READ_STAMP };
		}
		async updateKitchenTicket(id, data) {
		return simulateAction(id, { ...data });
		}
		async listKitchenStations(params) {
		return demoEmptyPage(params);
		}
		async listMenuItems(params) {
		return demoEmptyPage(params);
		}
		// ---------------------------------------------------------------- Banking
		async listBankAccounts(params) {
		return demoPage(demoBankAccounts, params);
		}
		async getBankAccount(id) {
		return findOrStub(demoBankAccounts, id);
		}
		async listTransactions(params) {
		return demoPage(demoTransactions, params);
		}
		async categorizeTransaction(id, data) {
		return simulateAction(id, { category: data.category, ...(data.notes ? { notes: data.notes } : {}) });
		}
		async matchTransactionToDocument(transactionId, data) {
		return simulateAction(transactionId, { matchedDocId: data.documentId, documentType: data.documentType });
		}
		// ---------------------------------------------------------------- Fiscal (simulated / read summaries)
		async getFiscalModeloSummary(modeloCode, period) {
		return { model: modeloCode, period: period ?? "2026-Q2", readonly: true, summary: { totalRevenue: 3960.4, totalExpenses: 405.6 }, ...FISCAL_STAMP };
		}
		async getVerifactuStatus(invoiceId) {
		return { invoiceId, status: "accepted", accepted: true, submittedAt: DEMO_NOW, ...FISCAL_STAMP };
		}
		async resubmitVerifactu(invoiceId) {
		return { invoiceId, status: "queued", ...FISCAL_STAMP };
		}
		async getTicketbaiStatus(invoiceId) {
		return { invoiceId, status: "success", province: "bizkaia", ...FISCAL_STAMP };
		}
		// ---------------------------------------------------------------- Time tracking
		async listTimeEntries(params) {
		return demoEmptyPage(params);
		}
		async getTimeEntry(id) {
		return { id, ...READ_STAMP };
		}
		async createTimeEntry(data) {
		return simulateWrite("demo_time", data);
		}
		async updateTimeEntry(id, data) {
		return simulateAction(id, { ...data });
		}
		async deleteTimeEntry(_id) {
		return;
		}
		async getTimeSummary(params) {
		return { from: params.from, to: params.to, totalHours: 0, billableHours: 0, nonBillableHours: 0, groups: [], ...READ_STAMP };
		}
		// ---------------------------------------------------------------- Recurring invoices
		async listRecurringInvoices(params) {
		return demoEmptyPage(params);
		}
		async getRecurringInvoice(id) {
		return { id, ...READ_STAMP };
		}
		async createRecurringInvoice(data) {
		return simulateWrite("demo_rec", data, { status: "active" });
		}
		async updateRecurringInvoice(id, data) {
		return simulateAction(id, { ...data });
		}
		async pauseRecurringInvoice(id) {
		return simulateAction(id, { status: "paused" });
		}
		async resumeRecurringInvoice(id) {
		return simulateAction(id, { status: "active" });
		}
		async deleteRecurringInvoice(_id) {
		return;
		}
		async runRecurringNow(templateId, options) {
		return simulateAction(templateId, { generatedInvoiceId: demoId("demo_inv"), draftOnly: options?.draftOnly ?? true });
		}
		// ---------------------------------------------------------------- Team management
		async listTeamMembers(params) {
		return demoEmptyPage(params);
		}
		async inviteTeamMember(data) {
		return simulateWrite("demo_member", { email: data.email, role: data.role, ...(data.name ? { name: data.name } : {}) }, { status: "pending" });
		}
		async updateTeamMemberRole(memberId, role) {
		return simulateAction(memberId, { role });
		}
		async removeTeamMember(_memberId) {
		return;
		}
		// ---------------------------------------------------------------- Audit GL
		async approveGLEntry(entryId, notes) {
		return simulateAction(entryId, { status: "approved", ...(notes ? { notes } : {}) });
		}
		async rejectGLEntry(entryId, reason) {
		return simulateAction(entryId, { status: "rejected", reason });
		}
		async getGLEntryAuditLog(entryId) {
		return { entryId, log: [], ...READ_STAMP };
		}
		// ---------------------------------------------------------------- White-label portal domain
		async addCustomPortalDomain(data) {
		return simulateWrite("demo_domain", { domain: data.domain }, { status: "pending_verification" });
		}
		async verifyCustomPortalDomain(data) {
		return { domain: data.domain, verified: true, ...FISCAL_STAMP };
		}
		async removeCustomPortalDomain(data) {
		return { domain: data.domain, removed: true, ...READ_STAMP };
		}
		// ---------------------------------------------------------------- Self-onboard + VIES
		async generatePortalOnboardLink(data) {
		return { email: data.email, url: "https://app.frihet.io/demo/onboard/DEMO-TOKEN", expiresInHours: data.expiresInHours ?? 72, ...READ_STAMP };
		}
		async lookupTaxIdViaVIES(data) {
		return { vatNumber: data.vatNumber, countryCode: data.countryCode, valid: true, name: "Demo EU Company", ...FISCAL_STAMP };
		}
		// ---------------------------------------------------------------- IGIC
		async getIgicModeloSummary(modeloCode, params) {
		return { model: modeloCode, year: params?.year ?? "2026", period: params?.period ?? "2T", readonly: true, ...FISCAL_STAMP };
		}
		async calculateAiem(data) {
		return { ncCode: data.ncCode, base: data.amount, aiemRate: 5, aiemAmount: Math.round(data.amount * 0.05 * 100) / 100, ...FISCAL_STAMP };
		}
		// ---------------------------------------------------------------- Impuesto Sociedades
		async getISSummary(modeloCode, params) {
		return { model: modeloCode, year: params?.year ?? "2026", installment: params?.installment ?? "1P", readonly: true, ...FISCAL_STAMP };
		}
		// ---------------------------------------------------------------- Bank rules
		async listBankRules(params) {
		return demoEmptyPage(params);
		}
		async createBankRule(data) {
		return simulateWrite("demo_rule", { name: data.name, conditions: data.conditions, actions: data.actions }, { isActive: data.isActive ?? true });
		}
		// ---------------------------------------------------------------- Gestoria
		async sendGestoriaMessage(data) {
		return simulateWrite("demo_gmsg", { parentType: data.parentType, parentId: data.parentId, body: data.body });
		}
		async listGestoriaMessages(_params) {
		return { messages: [], hasMore: false, ...READ_STAMP };
		}
		async createGestoriaTemplate(data) {
		return { templateId: demoId("demo_tpl"), ...FISCAL_STAMP };
		}
		async bulkSendGestoriaTemplate(data) {
		return { success: data.clientWorkspaceIds.length, failed: [], ...FISCAL_STAMP };
		}
		async getGestoriaAgingConsolidated(_params) {
		return { totals: { current: 0, "30_60": 0, "60_90": 0, "90_plus": 0 }, byWorkspace: [], topOverdue: [], generatedAt: DEMO_NOW, ...READ_STAMP };
		}
		// ---------------------------------------------------------------- HR
		async listLeaves(params) {
		return demoEmptyPage(params);
		}
		async createLeaveRequest(data) {
		return simulateWrite("demo_leave", { ...data }, { status: "pending" });
		}
		async approveLeave(leaveId, data) {
		return simulateAction(leaveId, { status: "approved", ...(data?.reason ? { decisionReason: data.reason } : {}) });
		}
		async rejectLeave(leaveId, data) {
		return simulateAction(leaveId, { status: "rejected", decisionReason: data.reason });
		}
		async cancelLeave(leaveId) {
		return simulateAction(leaveId, { status: "cancelled" });
		}
		async attendanceClockIn(data) {
		return simulateWrite("demo_att", { employeeId: data.employeeId, ...(data.mood ? { mood: data.mood } : {}), ...(data.location ? { location: data.location } : {}) }, { status: "open", clockInAt: DEMO_NOW });
		}
		async attendanceClockOut(entryId) {
		return simulateAction(entryId, { status: "closed", clockOutAt: DEMO_NOW });
		}
		async getOvertimeReport(params) {
		return { period: params.period, totalRegularHours: 0, totalOvertimeHours: 0, byEmployee: [], generatedAt: DEMO_NOW, ...READ_STAMP };
		}
		async listAnomalies(params) {
		return demoEmptyPage(params);
		}
		// ---------------------------------------------------------------- Webhook test
		async testWebhook(id, data) {
		return { webhookId: id, delivered: true, statusCode: 200, responseTimeMs: 42, eventType: data?.eventType ?? "ping", attemptedAt: DEMO_NOW, ...FISCAL_STAMP };
		}
		// ---------------------------------------------------------------- Payroll (simulated fiscal)
		async exportPayroll(params) {
		return { format: params.format, month: params.month, fileUrl: "https://app.frihet.io/demo/payroll.txt", filename: "demo-payroll.txt", rowCount: 0, generatedAt: DEMO_NOW, ...FISCAL_STAMP };
		}
		async getPayrollChecklist(params) {
		return { month: params.month, totalEmployees: 0, readyEmployees: 0, missingEmployees: 0, employees: [], generatedAt: DEMO_NOW, ...FISCAL_STAMP };
		}
		// ---------------------------------------------------------------- Onboarding
		async getOnboardingStatus() {
		return { workspaceId: "demo_ws_001", persona: "autonomo", completedSteps: ["profile"], pendingSteps: ["bank", "invoice"], percentComplete: 33, startedAt: DEMO_NOW, ...READ_STAMP };
		}
		async setOnboardingPersona(data) {
		return { workspaceId: "demo_ws_001", persona: data.persona, updatedAt: DEMO_NOW, ...READ_STAMP };
		}
		// ---------------------------------------------------------------- Permissions
		async getPermissionsMatrix() {
		return { roles: [{ role: "owner", permissions: ["*"] }], resources: ["invoices", "expenses", "clients"], generatedAt: DEMO_NOW, ...READ_STAMP };
		}
		async getMyPermissions() {
		return { userId: "demo_user_001", role: "owner", permissions: ["*"], workspaceId: "demo_ws_001", ...READ_STAMP };
		}
		// ---------------------------------------------------------------- Period close
		async getCurrentPeriod(params) {
		return { id: params?.periodId ?? "demo_period_2026_07", type: "monthly", status: "open", startDate: "2026-07-01", endDate: "2026-07-31", ...READ_STAMP };
		}
		async closePeriod(data) {
		return simulateWrite("demo_period", { type: data.type }, { status: "closed", closedAt: DEMO_NOW });
		}
		async reopenPeriod(data) {
		return simulateAction(data.periodId, { status: "reopened", reopenReason: data.reason });
		}
		}
		//# sourceMappingURL=demo-client.js.map

+1

dist/demo-client.js.map

+63

dist/demo-fixtures.d.ts

		/**
		* Demo-mode fixtures for the Frihet MCP server (`FRIHET_DEMO=1`).
		*
		* These are the canned, PII-SAFE example datasets served by DemoFrihetClient
		* when the server runs without an API key. NOTHING here is real customer data:
		* - NIF/CIF are AEAT example patterns (B12345678, X9999999X).
		* - IBAN is the ECBS/AEAT test IBAN (ES9121000418450200051332).
		* - Every email is under @example.com (guarded by demo-mode.test.ts).
		* - Business names are generic, invented ES/EU companies.
		*
		* Amounts follow the same field shape the real /v1 REST API returns (see
		* src/tools/*.ts output schemas + src/client-interface.ts return types), so an
		* agent evaluating the demo sees exactly the response shape it would get live.
		*/
		import type { PaginatedResponse } from "./types.js";
		/** Marker fields stamped on every demo response's top-level object. */
		export interface DemoStamp {
		_demo: true;
		_demoNotice: string;
		}
		/** Read/get/list responses. */
		export declare const READ_STAMP: DemoStamp;
		/** Simulated writes (create/update/apply/mark/etc.). */
		export declare const WRITE_STAMP: DemoStamp;
		/** Fiscal / e-invoice / email / payroll actions — NEVER a real submission. */
		export declare const FISCAL_STAMP: DemoStamp;
		/** Empty surfaces (no dedicated fixtures yet) still carry a demo stamp. */
		export declare const EMPTY_STAMP: DemoStamp;
		/** Frozen timestamp so demo responses are deterministic across calls. */
		export declare const DEMO_NOW = "2026-07-15T10:00:00.000Z";
		/** Test IBAN (ECBS/AEAT example — never a real account). */
		export declare const DEMO_TEST_IBAN = "ES9121000418450200051332";
		export type DemoPaginated = PaginatedResponse<Record<string, unknown>> & DemoStamp;
		/** Wrap a fixture array in a stamped PaginatedResponse. */
		export declare function demoPage(data: Record<string, unknown>[], params?: {
		limit?: number;
		offset?: number;
		}): DemoPaginated;
		/** Empty stamped PaginatedResponse for surfaces without dedicated fixtures. */
		export declare function demoEmptyPage(params?: {
		limit?: number;
		offset?: number;
		}): DemoPaginated;
		export declare const demoClients: Record<string, unknown>[];
		export declare const demoProducts: Record<string, unknown>[];
		export declare const demoInvoices: Record<string, unknown>[];
		export declare const demoExpenses: Record<string, unknown>[];
		export declare const demoQuotes: Record<string, unknown>[];
		export declare const demoVendors: Record<string, unknown>[];
		export declare const demoBankAccounts: Record<string, unknown>[];
		export declare const demoTransactions: Record<string, unknown>[];
		/** Find a fixture by id, or synthesize a minimal stamped object with that id. */
		export declare function findOrStub(collection: Record<string, unknown>[], id: string): Record<string, unknown> & DemoStamp;
		/** Deterministic-ish demo id (no network, no clock dependency). */
		export declare function demoId(prefix: string): string;
		/**
		* Simulate a create/update: echo the input, stamp a fabricated demo id +
		* timestamps + the WRITE banner. Never persists, never touches the network.
		*/
		export declare function simulateWrite(idPrefix: string, input: Record<string, unknown>, extra?: Record<string, unknown>): Record<string, unknown> & DemoStamp;
		/** Simulate an action on an existing entity (keeps the caller-supplied id). */
		export declare function simulateAction(id: string, fields?: Record<string, unknown>): Record<string, unknown> & DemoStamp;
		//# sourceMappingURL=demo-fixtures.d.ts.map

+1

dist/demo-fixtures.d.ts.map

{"version":3,"file":"demo-fixtures.d.ts","sourceRoot":"","sources":["../src/demo-fixtures.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAMpD,uEAAuE;AACvE,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,IAAI,CAAC;IACZ,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,+BAA+B;AAC/B,eAAO,MAAM,UAAU,EAAE,SAIf,CAAC;AAEX,wDAAwD;AACxD,eAAO,MAAM,WAAW,EAAE,SAIhB,CAAC;AAEX,8EAA8E;AAC9E,eAAO,MAAM,YAAY,EAAE,SAIjB,CAAC;AAEX,2EAA2E;AAC3E,eAAO,MAAM,WAAW,EAAE,SAIhB,CAAC;AAEX,yEAAyE;AACzE,eAAO,MAAM,QAAQ,6BAA6B,CAAC;AAEnD,4DAA4D;AAC5D,eAAO,MAAM,cAAc,6BAA6B,CAAC;AAMzD,MAAM,MAAM,aAAa,GAAG,iBAAiB,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC;AAEnF,2DAA2D;AAC3D,wBAAgB,QAAQ,CACtB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,EAC/B,MAAM,CAAC,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GAC3C,aAAa,CAQf;AAED,+EAA+E;AAC/E,wBAAgB,aAAa,CAAC,MAAM,CAAC,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,aAAa,CAQzF;AAMD,eAAO,MAAM,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAmDhD,CAAC;AAMF,eAAO,MAAM,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EASjD,CAAC;AAsDF,eAAO,MAAM,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAUjD,CAAC;AAMF,eAAO,MAAM,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAOjD,CAAC;AAMF,eAAO,MAAM,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAgC/C,CAAC;AAMF,eAAO,MAAM,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAGhD,CAAC;AAMF,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAYrD,CAAC;AAEF,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAKrD,CAAC;AAMF,iFAAiF;AACjF,wBAAgB,UAAU,CACxB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,EACrC,EAAE,EAAE,MAAM,GACT,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAIrC;AAID,mEAAmE;AACnE,wBAAgB,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAG7C;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,KAAK,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GAClC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CASrC;AAED,+EAA+E;AAC/E,wBAAgB,cAAc,CAC5B,EAAE,EAAE,MAAM,EACV,MAAM,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GACnC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAErC"}

+276

dist/demo-fixtures.js

		/**
		* Demo-mode fixtures for the Frihet MCP server (`FRIHET_DEMO=1`).
		*
		* These are the canned, PII-SAFE example datasets served by DemoFrihetClient
		* when the server runs without an API key. NOTHING here is real customer data:
		* - NIF/CIF are AEAT example patterns (B12345678, X9999999X).
		* - IBAN is the ECBS/AEAT test IBAN (ES9121000418450200051332).
		* - Every email is under @example.com (guarded by demo-mode.test.ts).
		* - Business names are generic, invented ES/EU companies.
		*
		* Amounts follow the same field shape the real /v1 REST API returns (see
		* src/tools/*.ts output schemas + src/client-interface.ts return types), so an
		* agent evaluating the demo sees exactly the response shape it would get live.
		*/
		/** Read/get/list responses. */
		export const READ_STAMP = {
		_demo: true,
		_demoNotice: "DEMO MODE — example data, nothing persisted. For real data: app.frihet.io → Settings → API keys.",
		};
		/** Simulated writes (create/update/apply/mark/etc.). */
		export const WRITE_STAMP = {
		_demo: true,
		_demoNotice: "DEMO MODE — example data, nothing persisted. Simulated — not persisted.",
		};
		/** Fiscal / e-invoice / email / payroll actions — NEVER a real submission. */
		export const FISCAL_STAMP = {
		_demo: true,
		_demoNotice: "Simulated fiscal action — no submission was made to any tax authority.",
		};
		/** Empty surfaces (no dedicated fixtures yet) still carry a demo stamp. */
		export const EMPTY_STAMP = {
		_demo: true,
		_demoNotice: "DEMO MODE — no demo fixtures for this surface yet. For real data: app.frihet.io → Settings → API keys.",
		};
		/** Frozen timestamp so demo responses are deterministic across calls. */
		export const DEMO_NOW = "2026-07-15T10:00:00.000Z";
		/** Test IBAN (ECBS/AEAT example — never a real account). */
		export const DEMO_TEST_IBAN = "ES9121000418450200051332";
		/** Wrap a fixture array in a stamped PaginatedResponse. */
		export function demoPage(data, params) {
		return {
		data,
		total: data.length,
		limit: params?.limit ?? 50,
		offset: params?.offset ?? 0,
		...READ_STAMP,
		};
		}
		/** Empty stamped PaginatedResponse for surfaces without dedicated fixtures. */
		export function demoEmptyPage(params) {
		return {
		data: [],
		total: 0,
		limit: params?.limit ?? 50,
		offset: params?.offset ?? 0,
		...EMPTY_STAMP,
		};
		}
		/* ------------------------------------------------------------------ */
		/* Clients (5) — mix of ES peninsula, Canarias (IGIC), autónomo, EU */
		/* ------------------------------------------------------------------ */
		export const demoClients = [
		{
		id: "demo_cli_001",
		name: "Panadería La Espiga SL",
		email: "hola@example.com",
		phone: "+34 600 000 001",
		taxId: "B12345678",
		address: { street: "Calle Mayor 12", city: "Madrid", state: "Madrid", postalCode: "28013", country: "ES" },
		createdAt: DEMO_NOW,
		updatedAt: DEMO_NOW,
		},
		{
		id: "demo_cli_002",
		name: "Estudio Nórdico Arquitectura SL",
		email: "info@example.com",
		phone: "+34 600 000 002",
		taxId: "B87654321",
		address: { street: "Passeig de Gràcia 45", city: "Barcelona", state: "Barcelona", postalCode: "08010", country: "ES" },
		createdAt: DEMO_NOW,
		updatedAt: DEMO_NOW,
		},
		{
		id: "demo_cli_003",
		name: "Servicios Insulares Canarias SL",
		email: "contacto@example.com",
		phone: "+34 600 000 003",
		taxId: "B35700000",
		address: { street: "Avenida de Anaga 8", city: "Santa Cruz de Tenerife", state: "Canarias", postalCode: "38001", country: "ES" },
		createdAt: DEMO_NOW,
		updatedAt: DEMO_NOW,
		},
		{
		id: "demo_cli_004",
		name: "Marina Delgado (autónoma)",
		email: "marina@example.com",
		phone: "+34 600 000 004",
		taxId: "X9999999X",
		address: { street: "Carrer de Colón 3", city: "Valencia", state: "Valencia", postalCode: "46004", country: "ES" },
		createdAt: DEMO_NOW,
		updatedAt: DEMO_NOW,
		},
		{
		id: "demo_cli_005",
		name: "TechFlow Solutions GmbH",
		email: "billing@example.com",
		phone: "+49 30 0000000",
		taxId: "DE123456789",
		address: { street: "Unter den Linden 10", city: "Berlin", state: "Berlin", postalCode: "10117", country: "DE" },
		createdAt: DEMO_NOW,
		updatedAt: DEMO_NOW,
		},
		];
		/* ------------------------------------------------------------------ */
		/* Products (8) — IVA 21% / 10% / 4% */
		/* ------------------------------------------------------------------ */
		export const demoProducts = [
		{ id: "demo_prd_001", name: "Consultoría estratégica (hora)", unitPrice: 90, taxRate: 21, description: "Sesión de consultoría por hora", createdAt: DEMO_NOW, updatedAt: DEMO_NOW },
		{ id: "demo_prd_002", name: "Desarrollo web (jornada)", unitPrice: 480, taxRate: 21, description: "Jornada de desarrollo full-stack", createdAt: DEMO_NOW, updatedAt: DEMO_NOW },
		{ id: "demo_prd_003", name: "Mantenimiento mensual", unitPrice: 150, taxRate: 21, description: "Soporte y mantenimiento mensual", createdAt: DEMO_NOW, updatedAt: DEMO_NOW },
		{ id: "demo_prd_004", name: "Diseño de marca", unitPrice: 1200, taxRate: 21, description: "Identidad visual completa", createdAt: DEMO_NOW, updatedAt: DEMO_NOW },
		{ id: "demo_prd_005", name: "Auditoría SEO", unitPrice: 600, taxRate: 21, description: "Auditoría técnica y de contenidos", createdAt: DEMO_NOW, updatedAt: DEMO_NOW },
		{ id: "demo_prd_006", name: "Formación in-company (hora)", unitPrice: 75, taxRate: 21, description: "Formación presencial por hora", createdAt: DEMO_NOW, updatedAt: DEMO_NOW },
		{ id: "demo_prd_007", name: "Menú catering (por persona)", unitPrice: 18, taxRate: 10, description: "Servicio de catering, IVA reducido hostelería", createdAt: DEMO_NOW, updatedAt: DEMO_NOW },
		{ id: "demo_prd_008", name: "Libro técnico impreso", unitPrice: 24, taxRate: 4, description: "Publicación impresa, IVA superreducido", createdAt: DEMO_NOW, updatedAt: DEMO_NOW },
		];
		function money(n) {
		return Math.round(n * 100) / 100;
		}
		function invoice(opts) {
		const subtotal = money(opts.items.reduce((s, i) => s + i.quantity * i.unitPrice, 0));
		const taxAmount = money(subtotal * (opts.taxRate / 100));
		const irpfAmount = opts.irpfRate ? money(subtotal * (opts.irpfRate / 100)) : 0;
		const total = money(subtotal + taxAmount - irpfAmount);
		return {
		id: opts.id,
		clientId: opts.clientId,
		clientName: opts.clientName,
		items: opts.items,
		issueDate: opts.issueDate,
		dueDate: opts.dueDate,
		status: opts.status,
		taxRate: opts.taxRate,
		subtotal,
		taxAmount,
		...(opts.irpfRate ? { irpfRate: opts.irpfRate, irpfAmount } : {}),
		total,
		currency: "EUR",
		...(opts.clientLocation ? { clientLocation: opts.clientLocation } : {}),
		...(opts.notes ? { notes: opts.notes } : {}),
		createdAt: DEMO_NOW,
		updatedAt: DEMO_NOW,
		};
		}
		export const demoInvoices = [
		invoice({ id: "demo_inv_001", clientId: "demo_cli_001", clientName: "Panadería La Espiga SL", items: [{ description: "Consultoría estratégica (hora)", quantity: 10, unitPrice: 90 }], taxRate: 21, status: "paid", issueDate: "2026-06-03", dueDate: "2026-07-03", clientLocation: "peninsula" }),
		invoice({ id: "demo_inv_002", clientId: "demo_cli_002", clientName: "Estudio Nórdico Arquitectura SL", items: [{ description: "Desarrollo web (jornada)", quantity: 5, unitPrice: 480 }], taxRate: 21, status: "sent", issueDate: "2026-06-10", dueDate: "2026-07-10", clientLocation: "peninsula" }),
		invoice({ id: "demo_inv_003", clientId: "demo_cli_003", clientName: "Servicios Insulares Canarias SL", items: [{ description: "Consultoría estratégica (hora)", quantity: 8, unitPrice: 90 }], taxRate: 7, status: "paid", issueDate: "2026-06-12", dueDate: "2026-07-12", notes: "IGIC 7% — cliente en Canarias", clientLocation: "canarias" }),
		invoice({ id: "demo_inv_004", clientId: "demo_cli_004", clientName: "Marina Delgado (autónoma)", items: [{ description: "Formación in-company (hora)", quantity: 12, unitPrice: 75 }], taxRate: 21, status: "draft", issueDate: "2026-07-01", dueDate: "2026-07-31", clientLocation: "peninsula" }),
		invoice({ id: "demo_inv_005", clientId: "demo_cli_001", clientName: "Panadería La Espiga SL", items: [{ description: "Menú catering (por persona)", quantity: 40, unitPrice: 18 }], taxRate: 10, status: "sent", issueDate: "2026-06-20", dueDate: "2026-07-20", notes: "IVA reducido 10% (hostelería)", clientLocation: "peninsula" }),
		invoice({ id: "demo_inv_006", clientId: "demo_cli_002", clientName: "Estudio Nórdico Arquitectura SL", items: [{ description: "Libro técnico impreso", quantity: 50, unitPrice: 24 }], taxRate: 4, status: "paid", issueDate: "2026-05-28", dueDate: "2026-06-28", notes: "IVA superreducido 4% (libros)", clientLocation: "peninsula" }),
		invoice({ id: "demo_inv_007", clientId: "demo_cli_005", clientName: "TechFlow Solutions GmbH", items: [{ description: "Consultoría estratégica (hora)", quantity: 20, unitPrice: 90 }], taxRate: 0, status: "sent", issueDate: "2026-06-15", dueDate: "2026-07-15", notes: "Inversión del sujeto pasivo (reverse charge, operación intracomunitaria B2B)", clientLocation: "eu" }),
		invoice({ id: "demo_inv_008", clientId: "demo_cli_003", clientName: "Servicios Insulares Canarias SL", items: [{ description: "Mantenimiento mensual", quantity: 3, unitPrice: 150 }], taxRate: 7, status: "overdue", issueDate: "2026-04-05", dueDate: "2026-05-05", notes: "IGIC 7% — factura vencida", clientLocation: "canarias" }),
		invoice({ id: "demo_inv_009", clientId: "demo_cli_004", clientName: "Marina Delgado (autónoma)", items: [{ description: "Diseño de marca", quantity: 1, unitPrice: 1200 }, { description: "Auditoría SEO", quantity: 1, unitPrice: 600 }], taxRate: 21, status: "draft", issueDate: "2026-07-08", dueDate: "2026-08-08", irpfRate: 15, notes: "Autónoma con retención IRPF 15%", clientLocation: "peninsula" }),
		];
		/* ------------------------------------------------------------------ */
		/* Expenses (6) — categorized */
		/* ------------------------------------------------------------------ */
		export const demoExpenses = [
		{ id: "demo_exp_001", description: "Suscripción software de diseño", amount: 15.4, category: "software", date: "2026-07-01", vendor: "Herramientas Digitales SL", taxDeductible: true, createdAt: DEMO_NOW, updatedAt: DEMO_NOW },
		{ id: "demo_exp_002", description: "Material de oficina", amount: 48.2, category: "office_supplies", date: "2026-06-18", vendor: "Papelería Central", taxDeductible: true, createdAt: DEMO_NOW, updatedAt: DEMO_NOW },
		{ id: "demo_exp_003", description: "Comida de trabajo con cliente", amount: 62.0, category: "meals", date: "2026-06-22", vendor: "Restaurante El Puerto", taxDeductible: true, createdAt: DEMO_NOW, updatedAt: DEMO_NOW },
		{ id: "demo_exp_004", description: "Combustible desplazamiento", amount: 70.0, category: "travel", date: "2026-06-25", vendor: "Estación de Servicio Norte", taxDeductible: true, createdAt: DEMO_NOW, updatedAt: DEMO_NOW },
		{ id: "demo_exp_005", description: "Cuota gestoría mensual", amount: 90.0, category: "professional_services", date: "2026-07-01", vendor: "Gestoría Ramírez", taxDeductible: true, createdAt: DEMO_NOW, updatedAt: DEMO_NOW },
		{ id: "demo_exp_006", description: "Hosting anual", amount: 120.0, category: "software", date: "2026-05-30", vendor: "Proveedor Cloud SL", taxDeductible: true, createdAt: DEMO_NOW, updatedAt: DEMO_NOW },
		];
		/* ------------------------------------------------------------------ */
		/* Quotes (2) */
		/* ------------------------------------------------------------------ */
		export const demoQuotes = [
		{
		id: "demo_quo_001",
		clientId: "demo_cli_002",
		clientName: "Estudio Nórdico Arquitectura SL",
		items: [{ description: "Desarrollo web (jornada)", quantity: 10, unitPrice: 480 }],
		taxRate: 21,
		subtotal: 4800,
		taxAmount: 1008,
		total: 5808,
		currency: "EUR",
		status: "sent",
		validUntil: "2026-08-15",
		createdAt: DEMO_NOW,
		updatedAt: DEMO_NOW,
		},
		{
		id: "demo_quo_002",
		clientId: "demo_cli_005",
		clientName: "TechFlow Solutions GmbH",
		items: [{ description: "Consultoría estratégica (hora)", quantity: 30, unitPrice: 90 }],
		taxRate: 0,
		subtotal: 2700,
		taxAmount: 0,
		total: 2700,
		currency: "EUR",
		status: "draft",
		validUntil: "2026-08-30",
		notes: "Reverse charge (intracomunitario B2B)",
		createdAt: DEMO_NOW,
		updatedAt: DEMO_NOW,
		},
		];
		/* ------------------------------------------------------------------ */
		/* Vendors (2) */
		/* ------------------------------------------------------------------ */
		export const demoVendors = [
		{ id: "demo_ven_001", name: "Gestoría Ramírez", email: "gestoria@example.com", phone: "+34 600 000 010", taxId: "B11111111", address: { city: "Madrid", postalCode: "28004", country: "ES" }, createdAt: DEMO_NOW, updatedAt: DEMO_NOW },
		{ id: "demo_ven_002", name: "Proveedor Cloud SL", email: "facturacion@example.com", phone: "+34 600 000 011", taxId: "B22222222", address: { city: "Barcelona", postalCode: "08007", country: "ES" }, createdAt: DEMO_NOW, updatedAt: DEMO_NOW },
		];
		/* ------------------------------------------------------------------ */
		/* Banking — 1 account + 4 transactions */
		/* ------------------------------------------------------------------ */
		export const demoBankAccounts = [
		{
		id: "demo_bank_001",
		alias: "Cuenta principal",
		iban: DEMO_TEST_IBAN,
		ibanLast4: "1332",
		currency: "EUR",
		balance: 12450.75,
		lastSyncedAt: DEMO_NOW,
		createdAt: DEMO_NOW,
		updatedAt: DEMO_NOW,
		},
		];
		export const demoTransactions = [
		{ id: "demo_txn_001", accountId: "demo_bank_001", amount: 1089.0, currency: "EUR", description: "Cobro factura demo_inv_001", postedAt: "2026-07-03", category: "sales_income", status: "posted", matchedDocId: "demo_inv_001", createdAt: DEMO_NOW, updatedAt: DEMO_NOW },
		{ id: "demo_txn_002", accountId: "demo_bank_001", amount: -90.0, currency: "EUR", description: "Cuota gestoría mensual", postedAt: "2026-07-01", category: "professional_services", status: "posted", createdAt: DEMO_NOW, updatedAt: DEMO_NOW },
		{ id: "demo_txn_003", accountId: "demo_bank_001", amount: -15.4, currency: "EUR", description: "Suscripción software de diseño", postedAt: "2026-07-01", category: "software", status: "posted", createdAt: DEMO_NOW, updatedAt: DEMO_NOW },
		{ id: "demo_txn_004", accountId: "demo_bank_001", amount: 770.4, currency: "EUR", description: "Cobro factura demo_inv_003", postedAt: "2026-07-12", category: "sales_income", status: "posted", matchedDocId: "demo_inv_003", createdAt: DEMO_NOW, updatedAt: DEMO_NOW },
		];
		/* ------------------------------------------------------------------ */
		/* Lookups + write simulation helpers */
		/* ------------------------------------------------------------------ */
		/** Find a fixture by id, or synthesize a minimal stamped object with that id. */
		export function findOrStub(collection, id) {
		const found = collection.find((item) => item.id === id);
		if (found)
		return { ...found, ...READ_STAMP };
		return { id, ...READ_STAMP };
		}
		let demoIdCounter = 0;
		/** Deterministic-ish demo id (no network, no clock dependency). */
		export function demoId(prefix) {
		demoIdCounter += 1;
		return `${prefix}_${String(demoIdCounter).padStart(3, "0")}`;
		}
		/**
		* Simulate a create/update: echo the input, stamp a fabricated demo id +
		* timestamps + the WRITE banner. Never persists, never touches the network.
		*/
		export function simulateWrite(idPrefix, input, extra = {}) {
		return {
		id: demoId(idPrefix),
		...input,
		...extra,
		createdAt: DEMO_NOW,
		updatedAt: DEMO_NOW,
		...WRITE_STAMP,
		};
		}
		/** Simulate an action on an existing entity (keeps the caller-supplied id). */
		export function simulateAction(id, fields = {}) {
		return { id, success: true, ...fields, updatedAt: DEMO_NOW, ...WRITE_STAMP };
		}
		//# sourceMappingURL=demo-fixtures.js.map

+1

dist/demo-fixtures.js.map

+15

-3

dist/index.js

		@@ -17,2 +17,3 @@ #!/usr/bin/env node
		import { FrihetClient } from "./client.js";
		import { DemoFrihetClient } from "./demo-client.js";
		// Single source of truth for the server version: package.json (read at runtime
		@@ -41,3 +42,8 @@ // from dist/../package.json). Hardcoding it here caused repeated version drift
		const apiKey = process.env.FRIHET_API_KEY;
		if (!apiKey) {
		// Demo mode: FRIHET_DEMO=1\|true serves fixture-backed example data with NO
		// network calls and NO API key required. It's an explicit opt-in, so it wins
		// even if a real key happens to be present. See demo-client.ts / demo-fixtures.ts.
		const demoFlag = process.env.FRIHET_DEMO;
		const demoMode = demoFlag === "1" \|\| demoFlag === "true";
		if (!demoMode && !apiKey) {
		console.error("Error: FRIHET_API_KEY environment variable is required.\n\n" +
		@@ -48,2 +54,3 @@ "Get your API key:\n" +
		" 3. Create a key and add it to your MCP configuration\n\n" +
		"Or try it instantly with no key: set FRIHET_DEMO=1 for example data.\n\n" +
		"Documentation: https://docs.frihet.io/desarrolladores/mcp-server\n");
		@@ -53,3 +60,3 @@ process.exit(1);
		const baseUrl = process.env.FRIHET_API_URL;
		if (baseUrl !== undefined) {
		if (!demoMode && baseUrl !== undefined) {
		let parsed;
		@@ -74,3 +81,8 @@ try {
		}
		const client = new FrihetClient(apiKey, baseUrl);
		const client = demoMode
		? new DemoFrihetClient()
		: new FrihetClient(apiKey, baseUrl);
		if (demoMode) {
		console.error("[frihet-mcp] DEMO MODE — serving example fixtures, no real data, nothing persisted");
		}
		// Set trace context for Langfuse (reads LANGFUSE_* from process.env automatically).
		@@ -77,0 +89,0 @@ // clientName can be overridden via FRIHET_CLIENT_NAME env var by the MCP host.

+1

-1

dist/index.js.map

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

+1

-1

dist/tools/einvoice.d.ts

		@@ -51,2 +51,3 @@ /**
		export declare const eInvoiceFormatSchema: z.ZodEnum<{
		facturae: "facturae";
		"xrechnung-cii": "xrechnung-cii";
		@@ -62,3 +63,2 @@ "xrechnung-ubl": "xrechnung-ubl";
		"peppol-bis-3": "peppol-bis-3";
		facturae: "facturae";
		}>;
		@@ -65,0 +65,0 @@ export type EInvoiceFormat = z.infer<typeof eInvoiceFormatSchema>;

+4

-4

dist/tools/shared.d.ts

		@@ -236,5 +236,5 @@ /**
		cancelled: "cancelled";
		completed: "completed";
		confirmed: "confirmed";
		pending: "pending";
		completed: "completed";
		no_show: "no_show";
		@@ -330,4 +330,4 @@ }>;
		cancelled: "cancelled";
		refunded: "refunded";
		pending: "pending";
		refunded: "refunded";
		partially_refunded: "partially_refunded";
		@@ -403,4 +403,4 @@ }>>;
		status: z.ZodOptional<z.ZodEnum<{
		posted: "posted";
		pending: "pending";
		posted: "posted";
		excluded: "excluded";
		@@ -845,4 +845,4 @@ }>>;
		closed: "closed";
		reopened: "reopened";
		closing: "closing";
		reopened: "reopened";
		}>>;
		@@ -849,0 +849,0 @@ startDate: z.ZodOptional<z.ZodString>;

+2

-2

package.json

		{
		"name": "@frihet/mcp-server",
		"version": "1.15.2",
		"version": "1.15.3",
		"description": "AI-native MCP server for business management — invoices, expenses, deposits, clients, products, quotes, webhooks, CRM, e-invoicing (Facturae/XRechnung/Factur-X/FatturaPA/PEPPOL + FACe Spain B2G + TicketBAI Basque Country + KSeF Poland), vacation rentals, POS, banking, fiscal (Modelo 303/130/390/180/347/415/425/418, VeriFactu, TicketBAI, IS M200/M202), IGIC, AIEM, GL audit approval, white-label portal domain, VIES EU VAT lookup, bank rules, time tracking, recurring invoices, team management, gestoria. 157 tools. Remote endpoint at mcp.frihet.io (zero install). Works with Claude, Cursor, Windsurf, Cline.",
		@@ -12,3 +12,3 @@ "type": "module",
		"build": "tsc",
		"test": "npm run build && node --test dist/__tests__/openai-profile.test.js dist/__tests__/tool-exposure.test.js dist/__tests__/einvoice-tools.test.js dist/__tests__/einvoice-day4-tools.test.js dist/__tests__/stay-tools.test.js dist/__tests__/pos-tools.test.js dist/__tests__/kitchen-tools.test.js dist/__tests__/banking-tools.test.js dist/__tests__/banking-client-contract.test.js dist/__tests__/pagination-cursor-param.test.js dist/__tests__/fiscal-tools.test.js dist/__tests__/time-tools.test.js dist/__tests__/recurring-tools.test.js dist/__tests__/team-tools.test.js dist/__tests__/d4b-hr-payroll-onboarding-tools.test.js dist/__tests__/audit-server-version.test.js dist/__tests__/openai-grouped-compose.test.js dist/__tests__/contract.test.js dist/__tests__/observability-redaction.test.js dist/__tests__/intelligence-duplicate-invoice.test.js dist/__tests__/get-envelope-unwrap-regression.test.js dist/__tests__/mutation-unwrap-and-schema-regression.test.js dist/__tests__/schema-envelope-guard.test.js",
		"test": "npm run build && node --test dist/__tests__/openai-profile.test.js dist/__tests__/tool-exposure.test.js dist/__tests__/einvoice-tools.test.js dist/__tests__/einvoice-day4-tools.test.js dist/__tests__/stay-tools.test.js dist/__tests__/pos-tools.test.js dist/__tests__/kitchen-tools.test.js dist/__tests__/banking-tools.test.js dist/__tests__/banking-client-contract.test.js dist/__tests__/pagination-cursor-param.test.js dist/__tests__/fiscal-tools.test.js dist/__tests__/time-tools.test.js dist/__tests__/recurring-tools.test.js dist/__tests__/team-tools.test.js dist/__tests__/d4b-hr-payroll-onboarding-tools.test.js dist/__tests__/audit-server-version.test.js dist/__tests__/openai-grouped-compose.test.js dist/__tests__/contract.test.js dist/__tests__/observability-redaction.test.js dist/__tests__/intelligence-duplicate-invoice.test.js dist/__tests__/get-envelope-unwrap-regression.test.js dist/__tests__/mutation-unwrap-and-schema-regression.test.js dist/__tests__/schema-envelope-guard.test.js dist/__tests__/demo-mode.test.js",
		"start": "node dist/index.js",
		@@ -15,0 +15,0 @@ "postinstall": "node scripts/postinstall.js \|\| true",

+33

-1

README.md

		@@ -42,3 +42,3 @@ <p align="center">

		> Tool count: npm `latest` (1.15.2) ships all 157 tools, same as the remote endpoint (`mcp.frihet.io`).
		> Tool count: npm `latest` (1.15.3) ships all 157 tools, same as the remote endpoint (`mcp.frihet.io`).

		@@ -62,2 +62,16 @@ ---

		## Try it instantly (no signup)

		Kick the tires with zero setup — no account, no API key:

		```bash
		FRIHET_DEMO=1 npx -y @frihet/mcp-server
		```

		In demo mode the server answers from realistic example fixtures (Spanish invoices with IVA/IGIC, expenses, clients, products, a bank account, and more) — every record uses `demo_`-prefixed IDs and the server prints a `DEMO MODE` banner on startup. Nothing is persisted and no network call is ever made. Writes are simulated and fiscal actions (e-invoice, VeriFactu, TicketBAI, FACe, payroll) return a clearly-labeled simulation — never a real submission to any tax authority.

		When you're ready for your real data, drop the flag and add your key ([app.frihet.io](https://app.frihet.io) → Settings → API keys). See [Install](#install) below.

		---

		## Install
		@@ -71,2 +85,20 @@

		### Claude Code plugin (skill + MCP server in one install)

		This repository is also a Claude Code plugin (`frihet-erp`): installing it wires up both the business-management skill and the MCP server.

		```bash
		# Try it locally
		claude --plugin-dir /path/to/frihet-mcp
		```

		Once available in the community marketplace:

		```text
		/plugin marketplace add anthropics/claude-plugins-community
		/plugin install frihet-erp@claude-community
		```

		Skill invocation: `/frihet-erp:frihet-mcp`. The bundled `.mcp.json` launches `@frihet/mcp-server` via `npx` — set `FRIHET_API_KEY` in your environment (get one at [app.frihet.io](https://app.frihet.io) → Settings → API keys).

		### Claude Code / Claude Desktop
		@@ -73,0 +105,0 @@

@frihet/mcp-server - npm Package Compare versions

New alerts

Fixed alerts

Improved metrics

Worsened metrics