@nubiia/mcp-freematica 0.6.1

package/dist/tools/contratos.js

@@ -0,0 +1,35 @@
+import { FreematicaError } from '../clients/base-client.js';
+import { error, okList } from './helpers.js';
+const LIST_MATERIALES_TOOL_NAME = 'freematica_list_materiales_asignados_servicios';
+const LIST_MATERIALES_TOOL_DESCRIPTION = [
+    'Devuelve la lista completa de material asignado a servicios.',
+    '',
+    'Endpoint: GET /pvss/v2/contratos-servicios-material (Freemática API).',
+    'Tipo de respuesta: VoContratosServMatAsignado[].',
+    '',
+    'Esta operación no acepta parámetros: siempre devuelve la lista entera para',
+    'la organización autenticada. La respuesta es un objeto con dos campos:',
+    '  - items: array de objetos VoContratosServMatAsignado',
+    '  - count: número total de elementos',
+].join('\n');
+/**
+ * Registers every MCP tool that maps to operations in the "Contratos" API group
+ * (Postman: app `pvss` → group `Contratos`).
+ *
+ * Add new tools here by calling `server.tool(...)` again. When this file grows
+ * past ~15 tools, split it into `src/tools/contratos/<entity>.ts`.
+ */
+export function registerContratosTools(server, client) {
+    server.tool(LIST_MATERIALES_TOOL_NAME, LIST_MATERIALES_TOOL_DESCRIPTION, {}, { readOnlyHint: true, destructiveHint: false, openWorldHint: true }, async () => {
+        try {
+            const { items, total } = await client.getMaterialesAsignadosServicios();
+            return okList({ items, total });
+        }
+        catch (err) {
+            if (err instanceof FreematicaError)
+                return error(err);
+            return error(err instanceof Error ? err : new Error(String(err)));
+        }
+    });
+}
+//# sourceMappingURL=contratos.js.map

package/dist/tools/contratos.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contratos.js","sourceRoot":"","sources":["../../src/tools/contratos.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAE5D,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAE7C,MAAM,yBAAyB,GAAG,gDAAgD,CAAC;AAEnF,MAAM,gCAAgC,GAAG;IACvC,8DAA8D;IAC9D,EAAE;IACF,uEAAuE;IACvE,kDAAkD;IAClD,EAAE;IACF,4EAA4E;IAC5E,wEAAwE;IACxE,wDAAwD;IACxD,sCAAsC;CACvC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAEb;;;;;;GAMG;AACH,MAAM,UAAU,sBAAsB,CAAC,MAAiB,EAAE,MAAwB;IAChF,MAAM,CAAC,IAAI,CACT,yBAAyB,EACzB,gCAAgC,EAChC,EAAE,EACF,EAAE,YAAY,EAAE,IAAI,EAAE,eAAe,EAAE,KAAK,EAAE,aAAa,EAAE,IAAI,EAAE,EACnE,KAAK,IAA6B,EAAE;QAClC,IAAI,CAAC;YACH,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,MAAM,MAAM,CAAC,+BAA+B,EAAE,CAAC;YACxE,OAAO,MAAM,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,CAAmB,CAAC;QACpD,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,GAAG,YAAY,eAAe;gBAAE,OAAO,KAAK,CAAC,GAAG,CAAmB,CAAC;YACxE,OAAO,KAAK,CAAC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAmB,CAAC;QACtF,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/facturas-compras.d.ts

@@ -0,0 +1,13 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { FreematicaClient } from '../clients/freematica-client.js';
+/**
+ * Registra las tools de facturas de compras en el servidor MCP.
+ *
+ * Tools registradas:
+ * - `freematica_list_facturas_compras`: lista paginada con filtros FIQL + exportado nativo.
+ * - `freematica_get_factura_compra`: detalle por idReg opaco.
+ *
+ * @param server - Instancia del servidor MCP.
+ * @param client - Cliente Freemática autenticado.
+ */
+export declare function registerFacturasComprasTools(server: McpServer, client: FreematicaClient): void;

package/dist/tools/facturas-compras.js

@@ -0,0 +1,131 @@
+import { z } from 'zod';
+import { FreematicaError } from '../clients/base-client.js';
+import { PaginationSchema } from '../schemas/pagination.js';
+import { DateRangeSchema } from '../schemas/filters.js';
+import { error, ok, okList } from './helpers.js';
+const LIST_TOOL_NAME = 'freematica_list_facturas_compras';
+const GET_TOOL_NAME = 'freematica_get_factura_compra';
+const LIST_DESCRIPTION = [
+    'Devuelve la lista paginada de facturas de compras de Freemática.',
+    '',
+    'Cada item contiene campos como FCC_CODEMP (empresa), FCC_CODPRO (proveedor), FCC_FCHFAC (fecha factura),',
+    'FCC_SERIEFRA (serie), FCC_NUMFRA (número), FCC_FPAGO (forma de pago), FCC_TRASP_CONTAB (traspasado contabilidad),',
+    'FCC_DELEG (delegación), FCC_LIN_NEGOCIO (línea negocio), más `idReg` opaco para el endpoint singular.',
+    '',
+    'Paginación 1-indexed. Los filtros de fecha aplican sobre la fecha de la factura (FCC_FCHFAC).',
+    '',
+    'El parámetro `exportado` acepta exactamente: "all" (todas) | "not_exported" (no exportadas).',
+    'Se envía como query param nativo, no como FIQL.',
+].join('\n');
+const GET_DESCRIPTION = [
+    'Devuelve el detalle completo de una factura de compra.',
+    '',
+    'El parámetro `id` DEBE ser el campo `idReg` (string opaco base64) que aparece en los items de',
+    'freematica_list_facturas_compras. NO usar FCC_NUMFRA ni otro código natural.',
+].join('\n');
+/**
+ * Enum nativo del endpoint de facturas de compras para el filtro de exportación.
+ *
+ * - `all`: todas las facturas independientemente de si han sido exportadas.
+ * - `not_exported`: sólo facturas que aún no han sido exportadas.
+ */
+const ExportadoEnum = z.enum(['all', 'not_exported']).optional().describe('Filtro de exportación. Valores: "all" (todas) | "not_exported" (no exportadas). ' +
+    'Se envía como query param nativo, no FIQL.');
+const LIST_SCHEMA = {
+    ...PaginationSchema,
+    ...DateRangeSchema.shape,
+    empresa: z
+        .string()
+        .min(1)
+        .optional()
+        .describe('Código de empresa (FCC_CODEMP en Freemática).'),
+    codProveedor: z
+        .string()
+        .min(1)
+        .optional()
+        .describe('Código natural del proveedor (FCC_CODPRO en Freemática).'),
+    serie: z
+        .string()
+        .min(1)
+        .optional()
+        .describe('Serie de la factura (FCC_SERIEFRA en Freemática).'),
+    numFactura: z
+        .string()
+        .min(1)
+        .optional()
+        .describe('Número de factura (FCC_NUMFRA en Freemática).'),
+    formaPago: z
+        .string()
+        .min(1)
+        .optional()
+        .describe('Código de forma de pago (FCC_FPAGO en Freemática).'),
+    traspasadoContabilidad: z
+        .boolean()
+        .optional()
+        .describe('Filtra facturas traspasadas a contabilidad (FCC_TRASP_CONTAB en Freemática).'),
+    delegacion: z
+        .string()
+        .min(1)
+        .optional()
+        .describe('Código de delegación (FCC_DELEG en Freemática).'),
+    lineaNegocio: z
+        .string()
+        .min(1)
+        .optional()
+        .describe('Código de línea de negocio (FCC_LIN_NEGOCIO en Freemática).'),
+    exportado: ExportadoEnum,
+};
+/**
+ * Registra las tools de facturas de compras en el servidor MCP.
+ *
+ * Tools registradas:
+ * - `freematica_list_facturas_compras`: lista paginada con filtros FIQL + exportado nativo.
+ * - `freematica_get_factura_compra`: detalle por idReg opaco.
+ *
+ * @param server - Instancia del servidor MCP.
+ * @param client - Cliente Freemática autenticado.
+ */
+export function registerFacturasComprasTools(server, client) {
+    server.tool(LIST_TOOL_NAME, LIST_DESCRIPTION, LIST_SCHEMA, { readOnlyHint: true, destructiveHint: false, openWorldHint: true }, async ({ page, items, fechaDesde, fechaHasta, empresa, codProveedor, serie, numFactura, formaPago, traspasadoContabilidad, delegacion, lineaNegocio, exportado, }) => {
+        try {
+            const result = await client.listFacturasCompras({
+                page,
+                items,
+                fechaDesde,
+                fechaHasta,
+                empresa,
+                codProveedor,
+                serie,
+                numFactura,
+                formaPago,
+                traspasadoContabilidad,
+                delegacion,
+                lineaNegocio,
+                exportado,
+            });
+            return okList({ items: result.items, total: result.total, page, itemsPerPage: items });
+        }
+        catch (err) {
+            if (err instanceof FreematicaError)
+                return error(err);
+            return error(err instanceof Error ? err : new Error(String(err)));
+        }
+    });
+    server.tool(GET_TOOL_NAME, GET_DESCRIPTION, {
+        id: z
+            .string()
+            .min(1)
+            .describe('idReg opaco de la factura de compra (campo "idReg" en los items de freematica_list_facturas_compras).'),
+    }, { readOnlyHint: true, destructiveHint: false, openWorldHint: true }, async ({ id }) => {
+        try {
+            const factura = await client.getFacturaCompra(id);
+            return ok(factura);
+        }
+        catch (err) {
+            if (err instanceof FreematicaError)
+                return error(err);
+            return error(err instanceof Error ? err : new Error(String(err)));
+        }
+    });
+}
+//# sourceMappingURL=facturas-compras.js.map

package/dist/tools/facturas-compras.js.map

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

package/dist/tools/facturas-electronicas.d.ts

@@ -0,0 +1,17 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { FreematicaClient } from '../clients/freematica-client.js';
+/**
+ * Registra las tools de facturas electrónicas (Facturae/EDICOM/FACe) en el servidor MCP.
+ *
+ * Tools registradas:
+ * - `freematica_list_facturas_electronicas`: lista paginada con filtros nativos (NO FIQL).
+ * - `freematica_get_factura_electronica`: detalle por idReg opaco.
+ * - `freematica_get_factura_documento`: documento binario en base64 con size guardrail.
+ * - `freematica_get_factura_log`: log de auditoría de eventos de una factura.
+ * - `freematica_get_edicom_info`: configuración de integración EDICOM.
+ * - `freematica_list_facturas_documentos`: descarga masiva de documentos con size guardrail.
+ *
+ * @param server - Instancia del servidor MCP.
+ * @param client - Cliente Freemática autenticado.
+ */
+export declare function registerFacturasElectronicasTools(server: McpServer, client: FreematicaClient): void;

package/dist/tools/facturas-electronicas.js

@@ -0,0 +1,268 @@
+import { z } from 'zod';
+import { FreematicaError } from '../clients/base-client.js';
+import { PaginationSchema } from '../schemas/pagination.js';
+import { ListFacturasElectronicasFiltersSchema, ListFacturasDocumentosFiltersSchema, } from '../schemas/facturas-electronicas.js';
+import { error, ok, okList } from './helpers.js';
+import { loadMaxResponseSizeMb } from '../utils/size-guardrail.js';
+// ---------------------------------------------------------------------------
+// Tool names
+// ---------------------------------------------------------------------------
+const LIST_TOOL_NAME = 'freematica_list_facturas_electronicas';
+const GET_TOOL_NAME = 'freematica_get_factura_electronica';
+const DOCUMENTO_TOOL_NAME = 'freematica_get_factura_documento';
+const LOG_TOOL_NAME = 'freematica_get_factura_log';
+const EDICOM_INFO_TOOL_NAME = 'freematica_get_edicom_info';
+const LIST_DOCUMENTOS_TOOL_NAME = 'freematica_list_facturas_documentos';
+// ---------------------------------------------------------------------------
+// Descriptions
+// ---------------------------------------------------------------------------
+const LIST_DESCRIPTION = [
+    'Devuelve la lista paginada de facturas electrónicas (Facturae firmadas / EDICOM / FACe) de Freemática.',
+    '',
+    'Diferente de freematica_list_facturas_cabecera: ésta expone las facturas firmadas y enviadas a AAPP/portales.',
+    'Los campos de respuesta usan el prefijo FACED_* (factura electrónica). Campos clave:',
+    '  FACED_CODEMP (empresa), FACED_FCHFAC (fecha), FACED_SERIEFRA (serie), FACED_NUMFRA (número),',
+    '  FACED_ESTADO / FACED_ESTADO_DESC (estado firma), FACED_LEIDO (flag leído),',
+    '  COD_CLI (código cliente), NIF, NOMBRE_CLI (nombre), TIENE_DOC_PDF / TIENE_DOC_XML (tiene documentos).',
+    '',
+    'Todos los filtros son query params nativos (NO FIQL). Paginación 1-indexed.',
+].join('\n');
+const GET_DESCRIPTION = [
+    'Devuelve el detalle completo de una factura electrónica (Facturae/EDICOM/FACe).',
+    '',
+    'El parámetro `id` DEBE ser el campo `idReg` (string opaco base64) que aparece en los items de',
+    'freematica_list_facturas_electronicas. NO usar FACED_NUMFRA ni otro código natural.',
+].join('\n');
+const DOCUMENTO_DESCRIPTION = [
+    'Devuelve el documento binario (PDF o XML Facturae firmado) de una factura electrónica.',
+    '',
+    'El documento se devuelve como objeto JSON con los campos de VoFacturasDocumento (FACED_DOCUMENTO_PDF,',
+    'FACED_DOCUMENTO_XML, FACED_DOCUMENTO_XML2, etc.) que contienen el contenido codificado en base64.',
+    '',
+    'Si el tamaño del response supera FREEMATICA_MAX_RESPONSE_SIZE_MB, se devuelve `truncated: true`',
+    'con `warning` y `sizeBytes` pero sin el contenido del documento.',
+    '',
+    'Parámetros opcionales:',
+    '  - documentType: tipo de documento a recuperar (ej. "PDF", "XML")',
+    '  - actualizaLeido: si true, marca la factura como leída al recuperar el documento',
+].join('\n');
+const LOG_DESCRIPTION = [
+    'Devuelve el log de auditoría de una factura electrónica: envío, recepción, aceptación AAPP, etc.',
+    '',
+    'El parámetro `id` DEBE ser el campo `idReg` opaco de freematica_list_facturas_electronicas.',
+    'Campos de respuesta con prefijo FVCTRLE_*:',
+    '  FVCTRLE_CODEMP (empresa), FVCTRLE_FCHFRA (fecha factura), FVCTRLE_SERIEFRA (serie),',
+    '  FVCTRLE_NUMFRA (número), FVCTRLE_FCH_MOV (fecha movimiento), FVCTRLE_CODCLI (cliente).',
+].join('\n');
+const EDICOM_INFO_DESCRIPTION = [
+    'Devuelve la configuración de integración con EDICOM (empresa emisora, aplicación, credenciales, URLs).',
+    '',
+    'Útil para diagnosticar el estado de la integración EDICOM/FACe y verificar la configuración.',
+    'Campos de respuesta: EDICOM_COMPANY_ID, EDICOM_APPLICATION, EDICOM_CLIENT_ID, EDICOM_DOMAIN,',
+    'EDICOM_SERVER_URL, EDICOM_RAZON_SOCIAL, EDICOM_MESSAGE_FORMAT, entre otros.',
+    '',
+    'NOTA: incluye campos sensibles (EDICOM_USER, EDICOM_PASSWORD). Usar con precaución.',
+].join('\n');
+const LIST_DOCUMENTOS_DESCRIPTION = [
+    'Descarga masiva de documentos de facturas electrónicas (PDF/XML/ERROR).',
+    '',
+    'Permite recuperar múltiples documentos a la vez filtrando por identificadores y tipo de documento.',
+    'Los documentos se devuelven en formato base64 dentro de los campos documentoPdf, documentoXml, etc.',
+    '',
+    'CUIDADO: este endpoint puede devolver respuestas muy grandes. Si supera FREEMATICA_MAX_RESPONSE_SIZE_MB',
+    'los items se truncarán y se añadirá `truncated: true` + `warning` en la respuesta.',
+    '',
+    'Campos de respuesta (prefijo VoEFraDoc): empresa, fecha, serie, numFra, documentoPdf, documentoXml,',
+    'documentoXml2, decError, decError2, documentoError, documentoGuid, documentoFSDir.',
+].join('\n');
+// ---------------------------------------------------------------------------
+// Registration
+// ---------------------------------------------------------------------------
+/**
+ * Registra las tools de facturas electrónicas (Facturae/EDICOM/FACe) en el servidor MCP.
+ *
+ * Tools registradas:
+ * - `freematica_list_facturas_electronicas`: lista paginada con filtros nativos (NO FIQL).
+ * - `freematica_get_factura_electronica`: detalle por idReg opaco.
+ * - `freematica_get_factura_documento`: documento binario en base64 con size guardrail.
+ * - `freematica_get_factura_log`: log de auditoría de eventos de una factura.
+ * - `freematica_get_edicom_info`: configuración de integración EDICOM.
+ * - `freematica_list_facturas_documentos`: descarga masiva de documentos con size guardrail.
+ *
+ * @param server - Instancia del servidor MCP.
+ * @param client - Cliente Freemática autenticado.
+ */
+export function registerFacturasElectronicasTools(server, client) {
+    // -------------------------------------------------------------------------
+    // 1. freematica_list_facturas_electronicas
+    // -------------------------------------------------------------------------
+    server.tool(LIST_TOOL_NAME, LIST_DESCRIPTION, ListFacturasElectronicasFiltersSchema, { readOnlyHint: true, destructiveHint: false, openWorldHint: true }, async ({ page, items, empresa, codCliente, fechaDesde, fechaHasta, estado, leido, order, }) => {
+        try {
+            const result = await client.listFacturasElectronicas({
+                page,
+                items,
+                empresa,
+                codCliente,
+                fechaDesde,
+                fechaHasta,
+                estado,
+                leido,
+                order,
+            });
+            return okList({ items: result.items, total: result.total, page, itemsPerPage: items });
+        }
+        catch (err) {
+            if (err instanceof FreematicaError)
+                return error(err);
+            return error(err instanceof Error ? err : new Error(String(err)));
+        }
+    });
+    // -------------------------------------------------------------------------
+    // 2. freematica_get_factura_electronica
+    // -------------------------------------------------------------------------
+    server.tool(GET_TOOL_NAME, GET_DESCRIPTION, {
+        id: z
+            .string()
+            .min(1)
+            .describe('idReg opaco de la factura electrónica (campo "idReg" en los items de freematica_list_facturas_electronicas).'),
+    }, { readOnlyHint: true, destructiveHint: false, openWorldHint: true }, async ({ id }) => {
+        try {
+            const factura = await client.getFacturaElectronica(id);
+            return ok(factura);
+        }
+        catch (err) {
+            if (err instanceof FreematicaError)
+                return error(err);
+            return error(err instanceof Error ? err : new Error(String(err)));
+        }
+    });
+    // -------------------------------------------------------------------------
+    // 3. freematica_get_factura_documento
+    // -------------------------------------------------------------------------
+    server.tool(DOCUMENTO_TOOL_NAME, DOCUMENTO_DESCRIPTION, {
+        id: z
+            .string()
+            .min(1)
+            .describe('idReg opaco de la factura electrónica (campo "idReg" en freematica_list_facturas_electronicas).'),
+        documentType: z
+            .string()
+            .optional()
+            .describe('Tipo de documento a recuperar: "PDF", "XML". Si no se especifica, devuelve el tipo por defecto.'),
+        actualizaLeido: z
+            .boolean()
+            .optional()
+            .describe('Si true, marca la factura como leída al recuperar el documento. Por defecto: false.'),
+    }, { readOnlyHint: true, destructiveHint: false, openWorldHint: true }, async ({ id, documentType, actualizaLeido }) => {
+        try {
+            const result = await client.getFacturaDocumento(id, { documentType, actualizaLeido });
+            return ok(result);
+        }
+        catch (err) {
+            if (err instanceof FreematicaError)
+                return error(err);
+            return error(err instanceof Error ? err : new Error(String(err)));
+        }
+    });
+    // -------------------------------------------------------------------------
+    // 4. freematica_get_factura_log
+    // -------------------------------------------------------------------------
+    server.tool(LOG_TOOL_NAME, LOG_DESCRIPTION, {
+        id: z
+            .string()
+            .min(1)
+            .describe('idReg opaco de la factura electrónica (campo "idReg" en freematica_list_facturas_electronicas).'),
+        ...PaginationSchema,
+    }, { readOnlyHint: true, destructiveHint: false, openWorldHint: true }, async ({ id, page, items }) => {
+        try {
+            const result = await client.getFacturaLog(id, { page, items });
+            return okList({ items: result.items, total: result.total, page, itemsPerPage: items });
+        }
+        catch (err) {
+            if (err instanceof FreematicaError)
+                return error(err);
+            return error(err instanceof Error ? err : new Error(String(err)));
+        }
+    });
+    // -------------------------------------------------------------------------
+    // 5. freematica_get_edicom_info
+    // -------------------------------------------------------------------------
+    server.tool(EDICOM_INFO_TOOL_NAME, EDICOM_INFO_DESCRIPTION, {
+        ...PaginationSchema,
+    }, { readOnlyHint: true, destructiveHint: false, openWorldHint: true }, async ({ page, items }) => {
+        try {
+            const result = await client.getEdicomInfo({ page, items });
+            return okList({ items: result.items, total: result.total, page, itemsPerPage: items });
+        }
+        catch (err) {
+            if (err instanceof FreematicaError)
+                return error(err);
+            return error(err instanceof Error ? err : new Error(String(err)));
+        }
+    });
+    // -------------------------------------------------------------------------
+    // 6. freematica_list_facturas_documentos
+    // -------------------------------------------------------------------------
+    server.tool(LIST_DOCUMENTOS_TOOL_NAME, LIST_DOCUMENTOS_DESCRIPTION, ListFacturasDocumentosFiltersSchema, { readOnlyHint: true, destructiveHint: false, openWorldHint: true }, async ({ documents, documentType }) => {
+        try {
+            const maxMb = loadMaxResponseSizeMb();
+            const maxBytes = maxMb * 1024 * 1024;
+            const result = await client.listFacturasDocumentos({ documents, documentType });
+            // Size guardrail for bulk document download
+            const serialized = JSON.stringify(result.items);
+            const sizeBytes = Buffer.byteLength(serialized, 'utf8');
+            if (sizeBytes > maxBytes) {
+                // Truncate items using binary search
+                const truncatedItems = truncateItemsToLimit(result.items, maxBytes);
+                return ok({
+                    items: truncatedItems,
+                    count: truncatedItems.length,
+                    total: result.total,
+                    truncated: true,
+                    warning: [
+                        `La respuesta ha sido truncada porque superaba el límite de ${maxMb} MB.`,
+                        `Items devueltos: ${truncatedItems.length} de ${result.items.length} totales.`,
+                        `Usa el parámetro "documents" con menos identificadores para obtener datos completos.`,
+                    ].join(' '),
+                });
+            }
+            return okList({ items: result.items, total: result.total });
+        }
+        catch (err) {
+            if (err instanceof FreematicaError)
+                return error(err);
+            return error(err instanceof Error ? err : new Error(String(err)));
+        }
+    });
+}
+// ---------------------------------------------------------------------------
+// Private helpers
+// ---------------------------------------------------------------------------
+/**
+ * Trunca un array de items para que su JSON serializado no supere `maxBytes`.
+ *
+ * Utiliza búsqueda binaria para encontrar eficientemente el número máximo de
+ * items que caben dentro del límite.
+ *
+ * @param items - Items originales.
+ * @param maxBytes - Límite en bytes.
+ * @returns Subarray de items que cabe dentro del límite.
+ */
+function truncateItemsToLimit(items, maxBytes) {
+    if (items.length === 0)
+        return [];
+    // Búsqueda binaria: encuentra el máximo n tal que JSON([0..n-1]) <= maxBytes
+    let lo = 0;
+    let hi = items.length;
+    while (lo < hi) {
+        const mid = Math.floor((lo + hi) / 2);
+        const size = Buffer.byteLength(JSON.stringify(items.slice(0, mid + 1)), 'utf8');
+        if (size <= maxBytes) {
+            lo = mid + 1;
+        }
+        else {
+            hi = mid;
+        }
+    }
+    return items.slice(0, lo);
+}
+//# sourceMappingURL=facturas-electronicas.js.map

package/dist/tools/facturas-electronicas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"facturas-electronicas.js","sourceRoot":"","sources":["../../src/tools/facturas-electronicas.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAE5D,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,EACL,qCAAqC,EACrC,mCAAmC,GACpC,MAAM,qCAAqC,CAAC;AAC7C,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AAEnE,8EAA8E;AAC9E,aAAa;AACb,8EAA8E;AAE9E,MAAM,cAAc,GAAG,uCAAuC,CAAC;AAC/D,MAAM,aAAa,GAAG,oCAAoC,CAAC;AAC3D,MAAM,mBAAmB,GAAG,kCAAkC,CAAC;AAC/D,MAAM,aAAa,GAAG,4BAA4B,CAAC;AACnD,MAAM,qBAAqB,GAAG,4BAA4B,CAAC;AAC3D,MAAM,yBAAyB,GAAG,qCAAqC,CAAC;AAExE,8EAA8E;AAC9E,eAAe;AACf,8EAA8E;AAE9E,MAAM,gBAAgB,GAAG;IACvB,wGAAwG;IACxG,EAAE;IACF,+GAA+G;IAC/G,sFAAsF;IACtF,gGAAgG;IAChG,8EAA8E;IAC9E,yGAAyG;IACzG,EAAE;IACF,6EAA6E;CAC9E,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAEb,MAAM,eAAe,GAAG;IACtB,iFAAiF;IACjF,EAAE;IACF,+FAA+F;IAC/F,qFAAqF;CACtF,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAEb,MAAM,qBAAqB,GAAG;IAC5B,wFAAwF;IACxF,EAAE;IACF,uGAAuG;IACvG,mGAAmG;IACnG,EAAE;IACF,iGAAiG;IACjG,kEAAkE;IAClE,EAAE;IACF,wBAAwB;IACxB,oEAAoE;IACpE,oFAAoF;CACrF,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAEb,MAAM,eAAe,GAAG;IACtB,kGAAkG;IAClG,EAAE;IACF,6FAA6F;IAC7F,4CAA4C;IAC5C,uFAAuF;IACvF,0FAA0F;CAC3F,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAEb,MAAM,uBAAuB,GAAG;IAC9B,wGAAwG;IACxG,EAAE;IACF,8FAA8F;IAC9F,8FAA8F;IAC9F,6EAA6E;IAC7E,EAAE;IACF,qFAAqF;CACtF,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAEb,MAAM,2BAA2B,GAAG;IAClC,yEAAyE;IACzE,EAAE;IACF,oGAAoG;IACpG,qGAAqG;IACrG,EAAE;IACF,yGAAyG;IACzG,oFAAoF;IACpF,EAAE;IACF,qGAAqG;IACrG,oFAAoF;CACrF,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAEb,8EAA8E;AAC9E,eAAe;AACf,8EAA8E;AAE9E;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,iCAAiC,CAAC,MAAiB,EAAE,MAAwB;IAC3F,4EAA4E;IAC5E,2CAA2C;IAC3C,4EAA4E;IAE5E,MAAM,CAAC,IAAI,CACT,cAAc,EACd,gBAAgB,EAChB,qCAAqC,EACrC,EAAE,YAAY,EAAE,IAAI,EAAE,eAAe,EAAE,KAAK,EAAE,aAAa,EAAE,IAAI,EAAE,EACnE,KAAK,EAAE,EACL,IAAI,EACJ,KAAK,EACL,OAAO,EACP,UAAU,EACV,UAAU,EACV,UAAU,EACV,MAAM,EACN,KAAK,EACL,KAAK,GACN,EAA2B,EAAE;QAC5B,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,wBAAwB,CAAC;gBACnD,IAAI;gBACJ,KAAK;gBACL,OAAO;gBACP,UAAU;gBACV,UAAU;gBACV,UAAU;gBACV,MAAM;gBACN,KAAK;gBACL,KAAK;aACN,CAAC,CAAC;YACH,OAAO,MAAM,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,IAAI,EAAE,YAAY,EAAE,KAAK,EAAE,CAAmB,CAAC;QAC3G,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,GAAG,YAAY,eAAe;gBAAE,OAAO,KAAK,CAAC,GAAG,CAAmB,CAAC;YACxE,OAAO,KAAK,CAAC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAmB,CAAC;QACtF,CAAC;IACH,CAAC,CACF,CAAC;IAEF,4EAA4E;IAC5E,wCAAwC;IACxC,4EAA4E;IAE5E,MAAM,CAAC,IAAI,CACT,aAAa,EACb,eAAe,EACf;QACE,EAAE,EAAE,CAAC;aACF,MAAM,EAAE;aACR,GAAG,CAAC,CAAC,CAAC;aACN,QAAQ,CACP,8GAA8G,CAC/G;KACJ,EACD,EAAE,YAAY,EAAE,IAAI,EAAE,eAAe,EAAE,KAAK,EAAE,aAAa,EAAE,IAAI,EAAE,EACnE,KAAK,EAAE,EAAE,EAAE,EAAE,EAA2B,EAAE;QACxC,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,qBAAqB,CAAC,EAAE,CAAC,CAAC;YACvD,OAAO,EAAE,CAAC,OAAO,CAAmB,CAAC;QACvC,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,GAAG,YAAY,eAAe;gBAAE,OAAO,KAAK,CAAC,GAAG,CAAmB,CAAC;YACxE,OAAO,KAAK,CAAC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAmB,CAAC;QACtF,CAAC;IACH,CAAC,CACF,CAAC;IAEF,4EAA4E;IAC5E,sCAAsC;IACtC,4EAA4E;IAE5E,MAAM,CAAC,IAAI,CACT,mBAAmB,EACnB,qBAAqB,EACrB;QACE,EAAE,EAAE,CAAC;aACF,MAAM,EAAE;aACR,GAAG,CAAC,CAAC,CAAC;aACN,QAAQ,CACP,iGAAiG,CAClG;QACH,YAAY,EAAE,CAAC;aACZ,MAAM,EAAE;aACR,QAAQ,EAAE;aACV,QAAQ,CAAC,iGAAiG,CAAC;QAC9G,cAAc,EAAE,CAAC;aACd,OAAO,EAAE;aACT,QAAQ,EAAE;aACV,QAAQ,CAAC,qFAAqF,CAAC;KACnG,EACD,EAAE,YAAY,EAAE,IAAI,EAAE,eAAe,EAAE,KAAK,EAAE,aAAa,EAAE,IAAI,EAAE,EACnE,KAAK,EAAE,EAAE,EAAE,EAAE,YAAY,EAAE,cAAc,EAAE,EAA2B,EAAE;QACtE,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,mBAAmB,CAAC,EAAE,EAAE,EAAE,YAAY,EAAE,cAAc,EAAE,CAAC,CAAC;YACtF,OAAO,EAAE,CAAC,MAAM,CAAmB,CAAC;QACtC,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,GAAG,YAAY,eAAe;gBAAE,OAAO,KAAK,CAAC,GAAG,CAAmB,CAAC;YACxE,OAAO,KAAK,CAAC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAmB,CAAC;QACtF,CAAC;IACH,CAAC,CACF,CAAC;IAEF,4EAA4E;IAC5E,gCAAgC;IAChC,4EAA4E;IAE5E,MAAM,CAAC,IAAI,CACT,aAAa,EACb,eAAe,EACf;QACE,EAAE,EAAE,CAAC;aACF,MAAM,EAAE;aACR,GAAG,CAAC,CAAC,CAAC;aACN,QAAQ,CACP,iGAAiG,CAClG;QACH,GAAG,gBAAgB;KACpB,EACD,EAAE,YAAY,EAAE,IAAI,EAAE,eAAe,EAAE,KAAK,EAAE,aAAa,EAAE,IAAI,EAAE,EACnE,KAAK,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,EAA2B,EAAE;QACrD,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,aAAa,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;YAC/D,OAAO,MAAM,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,IAAI,EAAE,YAAY,EAAE,KAAK,EAAE,CAAmB,CAAC;QAC3G,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,GAAG,YAAY,eAAe;gBAAE,OAAO,KAAK,CAAC,GAAG,CAAmB,CAAC;YACxE,OAAO,KAAK,CAAC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAmB,CAAC;QACtF,CAAC;IACH,CAAC,CACF,CAAC;IAEF,4EAA4E;IAC5E,gCAAgC;IAChC,4EAA4E;IAE5E,MAAM,CAAC,IAAI,CACT,qBAAqB,EACrB,uBAAuB,EACvB;QACE,GAAG,gBAAgB;KACpB,EACD,EAAE,YAAY,EAAE,IAAI,EAAE,eAAe,EAAE,KAAK,EAAE,aAAa,EAAE,IAAI,EAAE,EACnE,KAAK,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,EAA2B,EAAE;QACjD,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,aAAa,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;YAC3D,OAAO,MAAM,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,IAAI,EAAE,YAAY,EAAE,KAAK,EAAE,CAAmB,CAAC;QAC3G,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,GAAG,YAAY,eAAe;gBAAE,OAAO,KAAK,CAAC,GAAG,CAAmB,CAAC;YACxE,OAAO,KAAK,CAAC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAmB,CAAC;QACtF,CAAC;IACH,CAAC,CACF,CAAC;IAEF,4EAA4E;IAC5E,yCAAyC;IACzC,4EAA4E;IAE5E,MAAM,CAAC,IAAI,CACT,yBAAyB,EACzB,2BAA2B,EAC3B,mCAAmC,EACnC,EAAE,YAAY,EAAE,IAAI,EAAE,eAAe,EAAE,KAAK,EAAE,aAAa,EAAE,IAAI,EAAE,EACnE,KAAK,EAAE,EAAE,SAAS,EAAE,YAAY,EAAE,EAA2B,EAAE;QAC7D,IAAI,CAAC;YACH,MAAM,KAAK,GAAG,qBAAqB,EAAE,CAAC;YACtC,MAAM,QAAQ,GAAG,KAAK,GAAG,IAAI,GAAG,IAAI,CAAC;YAErC,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,sBAAsB,CAAC,EAAE,SAAS,EAAE,YAAY,EAAE,CAAC,CAAC;YAEhF,4CAA4C;YAC5C,MAAM,UAAU,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YAChD,MAAM,SAAS,GAAG,MAAM,CAAC,UAAU,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;YAExD,IAAI,SAAS,GAAG,QAAQ,EAAE,CAAC;gBACzB,qCAAqC;gBACrC,MAAM,cAAc,GAAG,oBAAoB,CAAC,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;gBACpE,OAAO,EAAE,CAAC;oBACR,KAAK,EAAE,cAAc;oBACrB,KAAK,EAAE,cAAc,CAAC,MAAM;oBAC5B,KAAK,EAAE,MAAM,CAAC,KAAK;oBACnB,SAAS,EAAE,IAAI;oBACf,OAAO,EAAE;wBACP,8DAA8D,KAAK,MAAM;wBACzE,oBAAoB,cAAc,CAAC,MAAM,OAAO,MAAM,CAAC,KAAK,CAAC,MAAM,WAAW;wBAC9E,sFAAsF;qBACvF,CAAC,IAAI,CAAC,GAAG,CAAC;iBACZ,CAAmB,CAAC;YACvB,CAAC;YAED,OAAO,MAAM,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,CAAmB,CAAC;QAChF,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,GAAG,YAAY,eAAe;gBAAE,OAAO,KAAK,CAAC,GAAG,CAAmB,CAAC;YACxE,OAAO,KAAK,CAAC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAmB,CAAC;QACtF,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC;AAED,8EAA8E;AAC9E,kBAAkB;AAClB,8EAA8E;AAE9E;;;;;;;;;GASG;AACH,SAAS,oBAAoB,CAC3B,KAAgC,EAChC,QAAgB;IAEhB,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAElC,6EAA6E;IAC7E,IAAI,EAAE,GAAG,CAAC,CAAC;IACX,IAAI,EAAE,GAAG,KAAK,CAAC,MAAM,CAAC;IAEtB,OAAO,EAAE,GAAG,EAAE,EAAE,CAAC;QACf,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;QACtC,MAAM,IAAI,GAAG,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,GAAG,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;QAChF,IAAI,IAAI,IAAI,QAAQ,EAAE,CAAC;YACrB,EAAE,GAAG,GAAG,GAAG,CAAC,CAAC;QACf,CAAC;aAAM,CAAC;YACN,EAAE,GAAG,GAAG,CAAC;QACX,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AAC5B,CAAC"}

package/dist/tools/facturas-ventas.d.ts

@@ -0,0 +1,16 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { FreematicaClient } from '../clients/freematica-client.js';
+/**
+ * Registra las tools MCP del dominio "Facturas de Ventas".
+ *
+ * Expone 5 tools:
+ * - `freematica_list_facturas_cabecera`: listado paginado de cabeceras con filtros FIQL
+ * - `freematica_get_factura_cabecera`: detalle de una factura por idReg
+ * - `freematica_list_factura_lineas`: líneas de una factura (path param: idFactura)
+ * - `freematica_list_factura_iva`: líneas de IVA de una factura (path param: idFactura)
+ * - `freematica_list_factura_vencimientos`: vencimientos de una factura (path param: idFactura)
+ *
+ * @param server - Instancia MCP donde se registran las tools.
+ * @param client - Cliente tipado de Freemática.
+ */
+export declare function registerFacturasVentasTools(server: McpServer, client: FreematicaClient): void;