@frihet/mcp-server 1.15.2 → 1.15.3

package/README.md

@@ -39,7 +39,7 @@
 | **ChatGPT Apps** | Coming soon | [chatgpt.com](https://chatgpt.com) |
 | **Anthropic Claude Directory** | Coming soon | [claude.ai/settings/connectors](https://claude.ai/settings/connectors) |
 
-> **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`).
 
 ---
 
@@ -58,6 +58,20 @@ Claude:  Done. Invoice INV-2026-089 created. Total: 3,000.00 EUR + 21% IVA = 3,6
 
 ---
 
+## 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
 
 ### One-line (Claude Code, Cursor, Copilot, Codex, Windsurf, Gemini CLI, and more)
@@ -66,6 +80,24 @@ Claude:  Done. Invoice INV-2026-089 created. Total: 3,000.00 EUR + 21% IVA = 3,6
 npx skills add Frihet-io/frihet-mcp
 ```
 
+### 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
 
 ```json

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

@@ -0,0 +1,11 @@
+/**
+ * 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

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

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

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

@@ -0,0 +1,119 @@
+/**
+ * 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

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

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

package/dist/demo-client.d.ts

@@ -0,0 +1,468 @@
+/**
+ * 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