@nubiia/mcp-freematica 0.6.1

package/dist/tools/facturas-ventas.js

@@ -0,0 +1,181 @@
+import { z } from 'zod';
+import { FreematicaError } from '../clients/base-client.js';
+import { ListFacturasCabeceraFiltersSchema, ListFacturaLineasFiltersSchema, ListFacturaIvaFiltersSchema, ListFacturaVencimientosFiltersSchema, } from '../schemas/facturas-ventas.js';
+import { error, ok, okList } from './helpers.js';
+const LIST_CABECERA_TOOL = 'freematica_list_facturas_cabecera';
+const GET_CABECERA_TOOL = 'freematica_get_factura_cabecera';
+const LIST_LINEAS_TOOL = 'freematica_list_factura_lineas';
+const LIST_IVA_TOOL = 'freematica_list_factura_iva';
+const LIST_VENCIMIENTOS_TOOL = 'freematica_list_factura_vencimientos';
+const LIST_CABECERA_DESCRIPTION = [
+    'Devuelve la lista paginada de cabeceras de facturas de ventas.',
+    '',
+    'Cada item contiene ~50 campos: FVC_NUMFAC (número factura), FVC_SERFAC (serie), FVC_CODAUX (cliente),',
+    'FVC_FECFAC (fecha factura), FVC_BASEIMPONIBLE (base), FVC_TOTFAC (total factura),',
+    'FVC_TRSCONT (traspasado a contabilidad), FVC_DELEG (delegación), más `idReg` opaco para el endpoint singular.',
+    '',
+    'Filtros disponibles:',
+    '- empresa, codCliente, representante',
+    '- fechaFacturaDesde/Hasta (rango de fecha factura)',
+    '- serie, numFactura (número exacto)',
+    '- formaPago, delegacion',
+    '- traspasadoContabilidad: true → solo facturas ya traspasadas a contabilidad',
+    '',
+    'Paginación 1-indexed. Default: page=1, items=20.',
+].join('\n');
+const GET_CABECERA_DESCRIPTION = [
+    'Devuelve el detalle completo de una factura de ventas (cabecera).',
+    '',
+    'El parámetro `id` DEBE ser el campo `idReg` (string opaco base64) que aparece en los items de',
+    'freematica_list_facturas_cabecera. NO usar FVC_NUMFAC ni FVC_SERFAC.',
+].join('\n');
+const LIST_LINEAS_DESCRIPTION = [
+    'Devuelve las líneas de detalle de una factura de ventas.',
+    '',
+    'Requiere el `idFactura` (idReg opaco) de la factura cabecera.',
+    '',
+    'Cada línea contiene: FVL_CODART (artículo), FVL_DESART (descripción), FVL_CANTFAC (cantidad),',
+    'FVL_PRECIOVENTA (precio), FVL_PORDTO (% descuento), FVL_IMPORTE (importe línea), FVL_CODFAM, FVL_CODSFAM.',
+    '',
+    'Filtros disponibles: codArticulo, codFamilia, codSubfamilia, delegacion.',
+].join('\n');
+const LIST_IVA_DESCRIPTION = [
+    'Devuelve las líneas de IVA de una factura de ventas.',
+    '',
+    'Requiere el `idFactura` (idReg opaco) de la factura cabecera.',
+    '',
+    'Cada línea contiene: FVI_TIPIVA (tipo IVA), FVI_PORCENTAJE (%), FVI_BASE (base imponible),',
+    'FVI_CUOTA (cuota IVA), FVI_TOTAL (total con IVA).',
+    '',
+    'Filtro disponible: tipoIva (FVI_TIPIVA exacto, ej. "21", "10", "4").',
+].join('\n');
+const LIST_VENCIMIENTOS_DESCRIPTION = [
+    'Devuelve los vencimientos de cobro de una factura de ventas.',
+    '',
+    'Requiere el `idFactura` (idReg opaco) de la factura cabecera.',
+    '',
+    'Cada vencimiento contiene: FVV_FECVCTO (fecha vencimiento), FVV_IMPORTE (importe a cobrar),',
+    'FVV_CODMPAG (modo de pago), FVV_ESTADO (estado del vencimiento).',
+    '',
+    'Filtros disponibles: fechaVencimientoDesde/Hasta, modoPago.',
+].join('\n');
+/** Schema del idFactura (path param compartido por lineas, iva y vencimientos). */
+const IdFacturaSchema = {
+    idFactura: z
+        .string()
+        .min(1)
+        .describe('idReg opaco de la factura cabecera (campo "idReg" en los items de freematica_list_facturas_cabecera).'),
+};
+/** Schema del id para get singular de cabecera. */
+const IdCabeceraSchema = {
+    id: z
+        .string()
+        .min(1)
+        .describe('idReg opaco de la factura (campo "idReg" en los items de freematica_list_facturas_cabecera).'),
+};
+/**
+ * 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 function registerFacturasVentasTools(server, client) {
+    // ---------------------------------------------------------------------------
+    // List facturas cabecera
+    // ---------------------------------------------------------------------------
+    server.tool(LIST_CABECERA_TOOL, LIST_CABECERA_DESCRIPTION, ListFacturasCabeceraFiltersSchema, { readOnlyHint: true, destructiveHint: false, openWorldHint: true }, async (args) => {
+        try {
+            const result = await client.listFacturasCabecera(args);
+            return okList({
+                items: result.items,
+                total: result.total,
+                page: args.page,
+                itemsPerPage: args.items,
+            });
+        }
+        catch (err) {
+            if (err instanceof FreematicaError)
+                return error(err);
+            return error(err instanceof Error ? err : new Error(String(err)));
+        }
+    });
+    // ---------------------------------------------------------------------------
+    // Get factura cabecera
+    // ---------------------------------------------------------------------------
+    server.tool(GET_CABECERA_TOOL, GET_CABECERA_DESCRIPTION, IdCabeceraSchema, { readOnlyHint: true, destructiveHint: false, openWorldHint: true }, async ({ id }) => {
+        try {
+            const factura = await client.getFacturaCabecera(id);
+            return ok(factura);
+        }
+        catch (err) {
+            if (err instanceof FreematicaError)
+                return error(err);
+            return error(err instanceof Error ? err : new Error(String(err)));
+        }
+    });
+    // ---------------------------------------------------------------------------
+    // List factura lineas
+    // ---------------------------------------------------------------------------
+    server.tool(LIST_LINEAS_TOOL, LIST_LINEAS_DESCRIPTION, { ...IdFacturaSchema, ...ListFacturaLineasFiltersSchema }, { readOnlyHint: true, destructiveHint: false, openWorldHint: true }, async ({ idFactura, ...filters }) => {
+        try {
+            const result = await client.listFacturaLineas(idFactura, filters);
+            return okList({
+                items: result.items,
+                total: result.total,
+                page: filters.page,
+                itemsPerPage: filters.items,
+            });
+        }
+        catch (err) {
+            if (err instanceof FreematicaError)
+                return error(err);
+            return error(err instanceof Error ? err : new Error(String(err)));
+        }
+    });
+    // ---------------------------------------------------------------------------
+    // List factura iva
+    // ---------------------------------------------------------------------------
+    server.tool(LIST_IVA_TOOL, LIST_IVA_DESCRIPTION, { ...IdFacturaSchema, ...ListFacturaIvaFiltersSchema }, { readOnlyHint: true, destructiveHint: false, openWorldHint: true }, async ({ idFactura, ...filters }) => {
+        try {
+            const result = await client.listFacturaIva(idFactura, filters);
+            return okList({
+                items: result.items,
+                total: result.total,
+                page: filters.page,
+                itemsPerPage: filters.items,
+            });
+        }
+        catch (err) {
+            if (err instanceof FreematicaError)
+                return error(err);
+            return error(err instanceof Error ? err : new Error(String(err)));
+        }
+    });
+    // ---------------------------------------------------------------------------
+    // List factura vencimientos
+    // ---------------------------------------------------------------------------
+    server.tool(LIST_VENCIMIENTOS_TOOL, LIST_VENCIMIENTOS_DESCRIPTION, { ...IdFacturaSchema, ...ListFacturaVencimientosFiltersSchema }, { readOnlyHint: true, destructiveHint: false, openWorldHint: true }, async ({ idFactura, ...filters }) => {
+        try {
+            const result = await client.listFacturaVencimientos(idFactura, filters);
+            return okList({
+                items: result.items,
+                total: result.total,
+                page: filters.page,
+                itemsPerPage: filters.items,
+            });
+        }
+        catch (err) {
+            if (err instanceof FreematicaError)
+                return error(err);
+            return error(err instanceof Error ? err : new Error(String(err)));
+        }
+    });
+}
+//# sourceMappingURL=facturas-ventas.js.map

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

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

package/dist/tools/helpers.d.ts

@@ -0,0 +1,17 @@
+import { type FreematicaErrorCode } from '../clients/base-client.js';
+export interface ToolTextContent {
+    type: 'text';
+    text: string;
+}
+export interface ToolResult {
+    content: ToolTextContent[];
+    isError?: boolean;
+}
+export declare function ok(data: unknown): ToolResult;
+export declare function okList(args: {
+    items: unknown[];
+    total: number;
+    page?: number;
+    itemsPerPage?: number;
+}): ToolResult;
+export declare function error(codeOrErr: FreematicaErrorCode | Error, message?: string): ToolResult;

package/dist/tools/helpers.js

@@ -0,0 +1,36 @@
+import { FreematicaError } from '../clients/base-client.js';
+export function ok(data) {
+    return {
+        content: [{ type: 'text', text: JSON.stringify(data, null, 2) }],
+    };
+}
+export function okList(args) {
+    return ok({
+        items: args.items,
+        count: args.items.length,
+        total: args.total,
+        page: args.page,
+        items_per_page: args.itemsPerPage,
+    });
+}
+export function error(codeOrErr, message) {
+    let code;
+    let msg;
+    if (codeOrErr instanceof FreematicaError) {
+        code = codeOrErr.code;
+        msg = codeOrErr.message;
+    }
+    else if (codeOrErr instanceof Error) {
+        code = 'unexpected_error';
+        msg = codeOrErr.message;
+    }
+    else {
+        code = codeOrErr;
+        msg = message ?? code;
+    }
+    return {
+        content: [{ type: 'text', text: JSON.stringify({ error: code, message: msg }, null, 2) }],
+        isError: true,
+    };
+}
+//# sourceMappingURL=helpers.js.map

package/dist/tools/helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.js","sourceRoot":"","sources":["../../src/tools/helpers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAA4B,MAAM,2BAA2B,CAAC;AAYtF,MAAM,UAAU,EAAE,CAAC,IAAa;IAC9B,OAAO;QACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;KACjE,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,MAAM,CAAC,IAKtB;IACC,OAAO,EAAE,CAAC;QACR,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM;QACxB,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,cAAc,EAAE,IAAI,CAAC,YAAY;KAClC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,KAAK,CAAC,SAAsC,EAAE,OAAgB;IAC5E,IAAI,IAAyB,CAAC;IAC9B,IAAI,GAAW,CAAC;IAEhB,IAAI,SAAS,YAAY,eAAe,EAAE,CAAC;QACzC,IAAI,GAAG,SAAS,CAAC,IAAI,CAAC;QACtB,GAAG,GAAG,SAAS,CAAC,OAAO,CAAC;IAC1B,CAAC;SAAM,IAAI,SAAS,YAAY,KAAK,EAAE,CAAC;QACtC,IAAI,GAAG,kBAAkB,CAAC;QAC1B,GAAG,GAAG,SAAS,CAAC,OAAO,CAAC;IAC1B,CAAC;SAAM,CAAC;QACN,IAAI,GAAG,SAAS,CAAC;QACjB,GAAG,GAAG,OAAO,IAAI,IAAI,CAAC;IACxB,CAAC;IAED,OAAO;QACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;QACzF,OAAO,EAAE,IAAI;KACd,CAAC;AACJ,CAAC"}

package/dist/tools/localizaciones.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 tres tools de localizaciones en el servidor MCP.
+ *
+ * Tools registradas:
+ * - `freematica_list_localizaciones_cobro_clientes`: cobros de clientes filtrados por
+ *   codCliente, grupoCliente y formaPago.
+ * - `freematica_list_localizaciones_pago_proveedores`: pagos de proveedores filtrados por
+ *   codProveedor, grupoProveedor y formaPago.
+ * - `freematica_list_localizaciones_servicio_clientes`: localizaciones de servicio de clientes
+ *   con filtros por cliente, grupo, país, provincia, representante y activo/baja.
+ *
+ * @param server - Instancia del servidor MCP.
+ * @param client - Cliente Freemática autenticado.
+ */
+export declare function registerLocalizacionesTools(server: McpServer, client: FreematicaClient): void;

package/dist/tools/localizaciones.js

@@ -0,0 +1,192 @@
+import { z } from 'zod';
+import { FreematicaError } from '../clients/base-client.js';
+import { PaginationSchema } from '../schemas/pagination.js';
+import { error, okList } from './helpers.js';
+const LIST_COBRO_CLIENTES_TOOL = 'freematica_list_localizaciones_cobro_clientes';
+const LIST_PAGO_PROVEEDORES_TOOL = 'freematica_list_localizaciones_pago_proveedores';
+const LIST_SERVICIO_CLIENTES_TOOL = 'freematica_list_localizaciones_servicio_clientes';
+const COBRO_CLIENTES_DESCRIPTION = [
+    'Devuelve la lista paginada de localizaciones de cobro de clientes.',
+    '',
+    'Las localizaciones de cobro definen la domiciliación bancaria o condiciones de pago de un cliente.',
+    'Cada item contiene campos como COD_CLI (cliente), GRUPO_CLI (grupo), COD_FORMA_COBRO (forma de cobro),',
+    'más `idReg` opaco.',
+    '',
+    'Paginación 1-indexed.',
+].join('\n');
+const PAGO_PROVEEDORES_DESCRIPTION = [
+    'Devuelve la lista paginada de localizaciones de pago de proveedores.',
+    '',
+    'Las localizaciones de pago definen las condiciones bancarias o de pago de un proveedor.',
+    'Cada item contiene campos como COD_PRO (proveedor), COD_GRUPO_PRO (grupo), COD_FORMA_PAGO (forma de pago),',
+    'más `idReg` opaco.',
+    '',
+    'Paginación 1-indexed.',
+].join('\n');
+const SERVICIO_CLIENTES_DESCRIPTION = [
+    'Devuelve la lista paginada de localizaciones de servicio de clientes.',
+    '',
+    'Las localizaciones de servicio son las direcciones donde se presta servicio a un cliente.',
+    'Cada item contiene campos como COD_CLI (cliente), GRUPO_CLI (grupo), COD_PAIS, COD_PROVINCIA,',
+    'COD_REPRES (representante), FECHA_BAJA (estado activo/baja), más `idReg` opaco.',
+    '',
+    'Paginación 1-indexed.',
+    '',
+    'El filtro `activo` es un booleano: true = sin fecha de baja (localizaciones activas);',
+    'false = con fecha de baja (dadas de baja).',
+].join('\n');
+// ---------------------------------------------------------------------------
+// Schemas individuales
+// ---------------------------------------------------------------------------
+const CobroClientesSchema = {
+    ...PaginationSchema,
+    codCliente: z
+        .string()
+        .min(1)
+        .optional()
+        .describe('Código natural del cliente (COD_CLI en Freemática).'),
+    grupoCliente: z
+        .string()
+        .min(1)
+        .optional()
+        .describe('Código de grupo de clientes (GRUPO_CLI en Freemática).'),
+    formaPago: z
+        .string()
+        .min(1)
+        .optional()
+        .describe('Código de forma de cobro (COD_FORMA_COBRO en Freemática).'),
+};
+const PagoProveedoresSchema = {
+    ...PaginationSchema,
+    codProveedor: z
+        .string()
+        .min(1)
+        .optional()
+        .describe('Código natural del proveedor (COD_PRO en Freemática).'),
+    grupoProveedor: z
+        .string()
+        .min(1)
+        .optional()
+        .describe('Código de grupo de proveedores (COD_GRUPO_PRO en Freemática).'),
+    formaPago: z
+        .string()
+        .min(1)
+        .optional()
+        .describe('Código de forma de pago (COD_FORMA_PAGO en Freemática).'),
+};
+const ServicioClientesSchema = {
+    ...PaginationSchema,
+    codCliente: z
+        .string()
+        .min(1)
+        .optional()
+        .describe('Código natural del cliente (COD_CLI en Freemática).'),
+    grupoCliente: z
+        .string()
+        .min(1)
+        .optional()
+        .describe('Código de grupo de clientes (GRUPO_CLI en Freemática).'),
+    codPais: z
+        .string()
+        .min(1)
+        .optional()
+        .describe('Código de país (COD_PAIS en Freemática).'),
+    codProvincia: z
+        .string()
+        .min(1)
+        .optional()
+        .describe('Código de provincia (COD_PROVINCIA en Freemática).'),
+    representante: z
+        .string()
+        .min(1)
+        .optional()
+        .describe('Código de representante asignado (COD_REPRES en Freemática).'),
+    activo: z
+        .boolean()
+        .optional()
+        .describe('Filtra por estado de la localización. true = sin fecha de baja (activas); ' +
+        'false = con fecha de baja (dadas de baja). FECHA_BAJA en Freemática.'),
+};
+// ---------------------------------------------------------------------------
+// Register function
+// ---------------------------------------------------------------------------
+/**
+ * Registra las tres tools de localizaciones en el servidor MCP.
+ *
+ * Tools registradas:
+ * - `freematica_list_localizaciones_cobro_clientes`: cobros de clientes filtrados por
+ *   codCliente, grupoCliente y formaPago.
+ * - `freematica_list_localizaciones_pago_proveedores`: pagos de proveedores filtrados por
+ *   codProveedor, grupoProveedor y formaPago.
+ * - `freematica_list_localizaciones_servicio_clientes`: localizaciones de servicio de clientes
+ *   con filtros por cliente, grupo, país, provincia, representante y activo/baja.
+ *
+ * @param server - Instancia del servidor MCP.
+ * @param client - Cliente Freemática autenticado.
+ */
+export function registerLocalizacionesTools(server, client) {
+    // --------------------------------------------------------------------------
+    // Tool 1: Localizaciones cobro clientes
+    // --------------------------------------------------------------------------
+    server.tool(LIST_COBRO_CLIENTES_TOOL, COBRO_CLIENTES_DESCRIPTION, CobroClientesSchema, { readOnlyHint: true, destructiveHint: false, openWorldHint: true }, async ({ page, items, codCliente, grupoCliente, formaPago }) => {
+        try {
+            const result = await client.listLocalizacionesCobroClientes({
+                page,
+                items,
+                codCliente,
+                grupoCliente,
+                formaPago,
+            });
+            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)));
+        }
+    });
+    // --------------------------------------------------------------------------
+    // Tool 2: Localizaciones pago proveedores
+    // --------------------------------------------------------------------------
+    server.tool(LIST_PAGO_PROVEEDORES_TOOL, PAGO_PROVEEDORES_DESCRIPTION, PagoProveedoresSchema, { readOnlyHint: true, destructiveHint: false, openWorldHint: true }, async ({ page, items, codProveedor, grupoProveedor, formaPago }) => {
+        try {
+            const result = await client.listLocalizacionesPagoProveedores({
+                page,
+                items,
+                codProveedor,
+                grupoProveedor,
+                formaPago,
+            });
+            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)));
+        }
+    });
+    // --------------------------------------------------------------------------
+    // Tool 3: Localizaciones servicio clientes
+    // --------------------------------------------------------------------------
+    server.tool(LIST_SERVICIO_CLIENTES_TOOL, SERVICIO_CLIENTES_DESCRIPTION, ServicioClientesSchema, { readOnlyHint: true, destructiveHint: false, openWorldHint: true }, async ({ page, items, codCliente, grupoCliente, codPais, codProvincia, representante, activo, }) => {
+        try {
+            const result = await client.listLocalizacionesServicioClientes({
+                page,
+                items,
+                codCliente,
+                grupoCliente,
+                codPais,
+                codProvincia,
+                representante,
+                activo,
+            });
+            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)));
+        }
+    });
+}
+//# sourceMappingURL=localizaciones.js.map

package/dist/tools/localizaciones.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"localizaciones.js","sourceRoot":"","sources":["../../src/tools/localizaciones.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,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAE7C,MAAM,wBAAwB,GAAG,+CAA+C,CAAC;AACjF,MAAM,0BAA0B,GAAG,iDAAiD,CAAC;AACrF,MAAM,2BAA2B,GAAG,kDAAkD,CAAC;AAEvF,MAAM,0BAA0B,GAAG;IACjC,oEAAoE;IACpE,EAAE;IACF,oGAAoG;IACpG,wGAAwG;IACxG,oBAAoB;IACpB,EAAE;IACF,uBAAuB;CACxB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAEb,MAAM,4BAA4B,GAAG;IACnC,sEAAsE;IACtE,EAAE;IACF,yFAAyF;IACzF,4GAA4G;IAC5G,oBAAoB;IACpB,EAAE;IACF,uBAAuB;CACxB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAEb,MAAM,6BAA6B,GAAG;IACpC,uEAAuE;IACvE,EAAE;IACF,2FAA2F;IAC3F,+FAA+F;IAC/F,iFAAiF;IACjF,EAAE;IACF,uBAAuB;IACvB,EAAE;IACF,uFAAuF;IACvF,4CAA4C;CAC7C,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAEb,8EAA8E;AAC9E,uBAAuB;AACvB,8EAA8E;AAE9E,MAAM,mBAAmB,GAAG;IAC1B,GAAG,gBAAgB;IACnB,UAAU,EAAE,CAAC;SACV,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,QAAQ,EAAE;SACV,QAAQ,CAAC,qDAAqD,CAAC;IAClE,YAAY,EAAE,CAAC;SACZ,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,QAAQ,EAAE;SACV,QAAQ,CAAC,wDAAwD,CAAC;IACrE,SAAS,EAAE,CAAC;SACT,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,QAAQ,EAAE;SACV,QAAQ,CAAC,2DAA2D,CAAC;CACzE,CAAC;AAEF,MAAM,qBAAqB,GAAG;IAC5B,GAAG,gBAAgB;IACnB,YAAY,EAAE,CAAC;SACZ,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,QAAQ,EAAE;SACV,QAAQ,CAAC,uDAAuD,CAAC;IACpE,cAAc,EAAE,CAAC;SACd,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,QAAQ,EAAE;SACV,QAAQ,CAAC,+DAA+D,CAAC;IAC5E,SAAS,EAAE,CAAC;SACT,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,QAAQ,EAAE;SACV,QAAQ,CAAC,yDAAyD,CAAC;CACvE,CAAC;AAEF,MAAM,sBAAsB,GAAG;IAC7B,GAAG,gBAAgB;IACnB,UAAU,EAAE,CAAC;SACV,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,QAAQ,EAAE;SACV,QAAQ,CAAC,qDAAqD,CAAC;IAClE,YAAY,EAAE,CAAC;SACZ,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,QAAQ,EAAE;SACV,QAAQ,CAAC,wDAAwD,CAAC;IACrE,OAAO,EAAE,CAAC;SACP,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,QAAQ,EAAE;SACV,QAAQ,CAAC,0CAA0C,CAAC;IACvD,YAAY,EAAE,CAAC;SACZ,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,QAAQ,EAAE;SACV,QAAQ,CAAC,oDAAoD,CAAC;IACjE,aAAa,EAAE,CAAC;SACb,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,QAAQ,EAAE;SACV,QAAQ,CAAC,8DAA8D,CAAC;IAC3E,MAAM,EAAE,CAAC;SACN,OAAO,EAAE;SACT,QAAQ,EAAE;SACV,QAAQ,CACP,4EAA4E;QAC5E,sEAAsE,CACvE;CACJ,CAAC;AAEF,8EAA8E;AAC9E,oBAAoB;AACpB,8EAA8E;AAE9E;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,2BAA2B,CAAC,MAAiB,EAAE,MAAwB;IACrF,6EAA6E;IAC7E,wCAAwC;IACxC,6EAA6E;IAE7E,MAAM,CAAC,IAAI,CACT,wBAAwB,EACxB,0BAA0B,EAC1B,mBAAmB,EACnB,EAAE,YAAY,EAAE,IAAI,EAAE,eAAe,EAAE,KAAK,EAAE,aAAa,EAAE,IAAI,EAAE,EACnE,KAAK,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,SAAS,EAAE,EAA2B,EAAE;QACtF,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,+BAA+B,CAAC;gBAC1D,IAAI;gBACJ,KAAK;gBACL,UAAU;gBACV,YAAY;gBACZ,SAAS;aACV,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,6EAA6E;IAC7E,0CAA0C;IAC1C,6EAA6E;IAE7E,MAAM,CAAC,IAAI,CACT,0BAA0B,EAC1B,4BAA4B,EAC5B,qBAAqB,EACrB,EAAE,YAAY,EAAE,IAAI,EAAE,eAAe,EAAE,KAAK,EAAE,aAAa,EAAE,IAAI,EAAE,EACnE,KAAK,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,SAAS,EAAE,EAA2B,EAAE;QAC1F,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,iCAAiC,CAAC;gBAC5D,IAAI;gBACJ,KAAK;gBACL,YAAY;gBACZ,cAAc;gBACd,SAAS;aACV,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,6EAA6E;IAC7E,2CAA2C;IAC3C,6EAA6E;IAE7E,MAAM,CAAC,IAAI,CACT,2BAA2B,EAC3B,6BAA6B,EAC7B,sBAAsB,EACtB,EAAE,YAAY,EAAE,IAAI,EAAE,eAAe,EAAE,KAAK,EAAE,aAAa,EAAE,IAAI,EAAE,EACnE,KAAK,EAAE,EACL,IAAI,EACJ,KAAK,EACL,UAAU,EACV,YAAY,EACZ,OAAO,EACP,YAAY,EACZ,aAAa,EACb,MAAM,GACP,EAA2B,EAAE;QAC5B,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,kCAAkC,CAAC;gBAC7D,IAAI;gBACJ,KAAK;gBACL,UAAU;gBACV,YAAY;gBACZ,OAAO;gBACP,YAAY;gBACZ,aAAa;gBACb,MAAM;aACP,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;AACJ,CAAC"}

package/dist/tools/master-data.d.ts

@@ -0,0 +1,10 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { FreematicaClient } from '../clients/freematica-client.js';
+/**
+ * Registra la tool freematica_get_master_data sobre el McpServer.
+ *
+ * Una sola tool expone los 24 catálogos vía un enum `catalog`. Añadir nuevos
+ * catálogos requiere actualizar `src/schemas/master-data.ts` (enum + record),
+ * no este archivo. Ver instrucciones en el JSDoc de MASTER_DATA_CATALOGS.
+ */
+export declare function registerMasterDataTools(server: McpServer, client: FreematicaClient): void;

package/dist/tools/master-data.js

@@ -0,0 +1,70 @@
+import { FreematicaError } from '../clients/base-client.js';
+import { MASTER_DATA_CATALOGS, MasterDataCatalogSchema, } from '../schemas/master-data.js';
+import { error, ok } from './helpers.js';
+const TOOL_NAME = 'freematica_get_master_data';
+const CATALOG_DESCRIPTIONS = [
+    // Tipos / clasificaciones
+    'tipos-contrato (tipos de contrato comercial)',
+    'tipo-instalacion (tipos de instalación física)',
+    'clases-servicios (clases de servicio operativas)',
+    'tipos-casos (CRM)',
+    'subtipos-casos (CRM)',
+    'tipos-oportunidad-negocio (CRM)',
+    'tipos-impuestos (IVA, IRPF, retenciones)',
+    'naturalezas-abono',
+    'incidencecode (códigos de incidencia en servicios)',
+    'claves-facturacion (claves de facturación de servicios)',
+    // Geográficos
+    'paises',
+    'nacionalidades',
+    'provincias',
+    'poblaciones (municipios — dataset grande, paginar con cuidado)',
+    // Organizativos
+    'empresas',
+    'delegaciones (agrupadas por código — listado global)',
+    'lineas-negocio',
+    'cargos-clientes (puestos de contactos)',
+    'calendarios (calendarios laborales — solo lookup; para detalle y períodos usar freematica_list_calendarios)',
+    'series (series de numeración de documentos)',
+    // Inventario
+    'familias (de artículos)',
+    'subfamilias',
+    'lineas (líneas de artículos)',
+    // Financiero
+    'bancos (entidades bancarias)',
+].join(', ');
+const TOOL_DESCRIPTION = [
+    'Devuelve un catálogo de datos maestros de Freemática (tipos, geográficos, organizativos, inventario, financiero).',
+    '',
+    `Catálogos disponibles (${MASTER_DATA_CATALOGS.length}): ${CATALOG_DESCRIPTIONS}.`,
+    '',
+    'Útil para traducir códigos crípticos en respuestas de otras tools (por ejemplo, los IDs de tipo de contrato o clase de servicio que aparecen en freematica_list_materiales_asignados_servicios).',
+    '',
+    'La respuesta es un objeto con tres campos:',
+    '  - catalog: el catálogo solicitado (echo del input)',
+    '  - items: array de objetos con los registros del catálogo',
+    '  - count: número total de elementos',
+].join('\n');
+/**
+ * Registra la tool freematica_get_master_data sobre el McpServer.
+ *
+ * Una sola tool expone los 24 catálogos vía un enum `catalog`. Añadir nuevos
+ * catálogos requiere actualizar `src/schemas/master-data.ts` (enum + record),
+ * no este archivo. Ver instrucciones en el JSDoc de MASTER_DATA_CATALOGS.
+ */
+export function registerMasterDataTools(server, client) {
+    server.tool(TOOL_NAME, TOOL_DESCRIPTION, {
+        catalog: MasterDataCatalogSchema.describe(`Catálogo a consultar. Valores válidos: ${CATALOG_DESCRIPTIONS}.`),
+    }, { readOnlyHint: true, destructiveHint: false, openWorldHint: true }, async ({ catalog }) => {
+        try {
+            const { items, total } = await client.getMasterData(catalog);
+            return ok({ catalog, items, count: items.length, total });
+        }
+        catch (err) {
+            if (err instanceof FreematicaError)
+                return error(err);
+            return error(err instanceof Error ? err : new Error(String(err)));
+        }
+    });
+}
+//# sourceMappingURL=master-data.js.map

package/dist/tools/master-data.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"master-data.js","sourceRoot":"","sources":["../../src/tools/master-data.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAE5D,OAAO,EACL,oBAAoB,EACpB,uBAAuB,GACxB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,MAAM,cAAc,CAAC;AAEzC,MAAM,SAAS,GAAG,4BAA4B,CAAC;AAE/C,MAAM,oBAAoB,GAAG;IAC3B,0BAA0B;IAC1B,8CAA8C;IAC9C,gDAAgD;IAChD,kDAAkD;IAClD,mBAAmB;IACnB,sBAAsB;IACtB,iCAAiC;IACjC,0CAA0C;IAC1C,mBAAmB;IACnB,oDAAoD;IACpD,yDAAyD;IACzD,cAAc;IACd,QAAQ;IACR,gBAAgB;IAChB,YAAY;IACZ,gEAAgE;IAChE,gBAAgB;IAChB,UAAU;IACV,sDAAsD;IACtD,gBAAgB;IAChB,wCAAwC;IACxC,6GAA6G;IAC7G,6CAA6C;IAC7C,aAAa;IACb,yBAAyB;IACzB,aAAa;IACb,8BAA8B;IAC9B,aAAa;IACb,8BAA8B;CAC/B,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAEb,MAAM,gBAAgB,GAAG;IACvB,mHAAmH;IACnH,EAAE;IACF,0BAA0B,oBAAoB,CAAC,MAAM,MAAM,oBAAoB,GAAG;IAClF,EAAE;IACF,kMAAkM;IAClM,EAAE;IACF,4CAA4C;IAC5C,sDAAsD;IACtD,4DAA4D;IAC5D,sCAAsC;CACvC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAEb;;;;;;GAMG;AACH,MAAM,UAAU,uBAAuB,CAAC,MAAiB,EAAE,MAAwB;IACjF,MAAM,CAAC,IAAI,CACT,SAAS,EACT,gBAAgB,EAChB;QACE,OAAO,EAAE,uBAAuB,CAAC,QAAQ,CACvC,0CAA0C,oBAAoB,GAAG,CAClE;KACF,EACD,EAAE,YAAY,EAAE,IAAI,EAAE,eAAe,EAAE,KAAK,EAAE,aAAa,EAAE,IAAI,EAAE,EACnE,KAAK,EAAE,EAAE,OAAO,EAAE,EAA2B,EAAE;QAC7C,IAAI,CAAC;YACH,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,MAAM,MAAM,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;YAC7D,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,MAAM,EAAE,KAAK,EAAE,CAAmB,CAAC;QAC9E,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/oportunidades-negocio.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { FreematicaClient } from '../clients/freematica-client.js';
+export declare function registerOportunidadesNegocioTools(server: McpServer, client: FreematicaClient): void;

package/dist/tools/oportunidades-negocio.js

@@ -0,0 +1,68 @@
+import { z } from 'zod';
+import { FreematicaError } from '../clients/base-client.js';
+import { PaginationSchema } from '../schemas/pagination.js';
+import { error, ok, okList } from './helpers.js';
+const LIST_TOOL_NAME = 'freematica_list_oportunidades_negocio';
+const GET_TOOL_NAME = 'freematica_get_oportunidad_negocio';
+const AMP_TOOL_NAME = 'freematica_get_oportunidad_negocio_datos_ampliados';
+const LIST_DESCRIPTION = [
+    'Devuelve la lista paginada de oportunidades de negocio (CRM).',
+    '',
+    'Cada item tiene ~33 campos: COD_CLI (id del cliente), COD_ESTADO_OPOR, COD_ETAPA_OPOR, NOMBRE, VALOR, ID_OPORTUNIDAD, FECHA, FECHA_CREACION, USU_ASIGNADO, etc. Más `idReg` opaco para el endpoint singular.',
+    '',
+    'Paginación 1-indexed.',
+].join('\n');
+const GET_DESCRIPTION = [
+    'Devuelve el detalle de una oportunidad de negocio.',
+    '',
+    'El parámetro `id` DEBE ser el `idReg` opaco que aparece en los items de freematica_list_oportunidades_negocio.',
+].join('\n');
+const AMP_DESCRIPTION = [
+    'Devuelve los datos ampliados de una oportunidad de negocio.',
+    '',
+    'NOTA: Este endpoint puede devolver `not_found` si la oportunidad no tiene datos ampliados configurados. Es un caso esperado, no un error de software — explicarle al usuario que esa oportunidad no tiene info adicional.',
+    '',
+    'El parámetro `id` DEBE ser el `idReg` opaco (mismo que en get_oportunidad_negocio).',
+].join('\n');
+const IdSchema = {
+    id: z
+        .string()
+        .min(1)
+        .describe('idReg opaco de la oportunidad (campo "idReg" en los items de freematica_list_oportunidades_negocio).'),
+};
+export function registerOportunidadesNegocioTools(server, client) {
+    server.tool(LIST_TOOL_NAME, LIST_DESCRIPTION, PaginationSchema, { readOnlyHint: true, destructiveHint: false, openWorldHint: true }, async ({ page, items }) => {
+        try {
+            const result = await client.listOportunidadesNegocio({ 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)));
+        }
+    });
+    server.tool(GET_TOOL_NAME, GET_DESCRIPTION, IdSchema, { readOnlyHint: true, destructiveHint: false, openWorldHint: true }, async ({ id }) => {
+        try {
+            const opo = await client.getOportunidadNegocio(id);
+            return ok(opo);
+        }
+        catch (err) {
+            if (err instanceof FreematicaError)
+                return error(err);
+            return error(err instanceof Error ? err : new Error(String(err)));
+        }
+    });
+    server.tool(AMP_TOOL_NAME, AMP_DESCRIPTION, IdSchema, { readOnlyHint: true, destructiveHint: false, openWorldHint: true }, async ({ id }) => {
+        try {
+            const datos = await client.getOportunidadNegocioDatosAmpliados(id);
+            return ok(datos);
+        }
+        catch (err) {
+            if (err instanceof FreematicaError)
+                return error(err);
+            return error(err instanceof Error ? err : new Error(String(err)));
+        }
+    });
+}
+//# sourceMappingURL=oportunidades-negocio.js.map

package/dist/tools/oportunidades-negocio.js.map

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