@nubiia/mcp-freematica 0.6.3 → 0.7.0

package/dist/tools/contratos/cabecera.js

@@ -0,0 +1,128 @@
+import { z } from 'zod';
+import { FreematicaError } from '../../clients/base-client.js';
+import { PaginationSchema } from '../../schemas/pagination.js';
+import { CreateContratoShape, UpdateContratoShape, buildContratoBody, } from '../../schemas/contratos.js';
+import { error, ok, okList } from '../helpers.js';
+const LIST_TOOL_NAME = 'freematica_list_contratos';
+const GET_TOOL_NAME = 'freematica_get_contrato';
+const CREATE_TOOL_NAME = 'freematica_create_contrato';
+const UPDATE_TOOL_NAME = 'freematica_update_contrato';
+const LIST_DESCRIPTION = [
+    'Devuelve la lista paginada de cabeceras de contratos (módulo Contratos y Servicios).',
+    '',
+    'Endpoint: GET /pvss/v1/contratos. Cada item tiene campos CTRT_* (CTRT_EMP,',
+    'CTRT_DELEG, CTRT_COD, CTRT_DES, CTRT_FECHA, CTRT_COD_CLI, dirección,',
+    'CTRT_ABIERTO…) más `idReg` opaco (Base64 "EMP__DELEG__COD") que se usa en el',
+    'resto de tools de contratos.',
+    '',
+    'Filtros disponibles: SOLO empresa y delegacion (params nativos del API).',
+    'AVISO: el API ignora silenciosamente los filtros FIQL en este endpoint;',
+    'para localizar un contrato concreto usa freematica_get_contrato.',
+].join('\n');
+const GET_DESCRIPTION = [
+    'Busca una cabecera de contrato por sus códigos naturales (empresa + código',
+    'de contrato, opcionalmente delegación).',
+    '',
+    'No existe endpoint singular en el API y el listado ignora los filtros FIQL,',
+    'así que esta tool pagina el listado internamente (200 items por página) y',
+    'filtra en cliente. Puede requerir varias llamadas al API en datasets grandes.',
+    'Devuelve not_found si no hay coincidencia.',
+].join('\n');
+const CREATE_DESCRIPTION = [
+    'Da de alta una cabecera de contrato (módulo Contratos y Servicios).',
+    '',
+    'Endpoint: POST /pvss/v2/contratos — body VoContratos.',
+    'Requeridos: delegacion, descripcion (máx 40c), fecha, codCliente.',
+    'Si no se informa codContrato, Freemática asigna el código automáticamente.',
+    '',
+    'IMPORTANTE: el API no valida referencias de negocio en el spec (p. ej. que',
+    'codCliente exista); verifica los códigos con freematica_list_clientes antes.',
+    'Devuelve el contrato creado, incluido su idReg.',
+].join('\n');
+const UPDATE_DESCRIPTION = [
+    'Actualiza la cabecera de un contrato existente.',
+    '',
+    'Endpoint: PUT /pvss/v2/contratos/{idReg} — body VoContratos.',
+    '`idReg` es el identificador opaco del contrato (de freematica_list_contratos',
+    'o freematica_get_contrato). Solo se envían al API los campos informados.',
+].join('\n');
+/** Tools de cabecera de contrato: list/get (lectura) + create/update (escritura). */
+export function registerCabeceraTools(server, client, opts) {
+    server.tool(LIST_TOOL_NAME, LIST_DESCRIPTION, {
+        ...PaginationSchema,
+        empresa: z.string().max(4).optional().describe('Código de empresa (param nativo codEmpresa).'),
+        delegacion: z
+            .string()
+            .max(4)
+            .optional()
+            .describe('Código de delegación (param nativo codDelegacion).'),
+        order: z
+            .string()
+            .optional()
+            .describe('Orden de los registros. Ejemplo: "CTRT_FECHA desc".'),
+    }, { readOnlyHint: true, destructiveHint: false, openWorldHint: true }, async ({ page, items, empresa, delegacion, order }) => {
+        try {
+            const result = await client.listContratos({ page, items, empresa, delegacion, 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)));
+        }
+    });
+    server.tool(GET_TOOL_NAME, GET_DESCRIPTION, {
+        empresa: z.string().max(4).describe('Código de empresa (CTRT_EMP). Ej: "02".'),
+        codContrato: z.string().max(10).describe('Código del contrato (CTRT_COD). Ej: "2304".'),
+        delegacion: z
+            .string()
+            .max(4)
+            .optional()
+            .describe('Código de delegación (CTRT_DELEG). Acota la búsqueda si se conoce.'),
+    }, { readOnlyHint: true, destructiveHint: false, openWorldHint: true }, async ({ empresa, codContrato, delegacion }) => {
+        try {
+            const contrato = await client.getContrato({ empresa, codContrato, delegacion });
+            return ok(contrato);
+        }
+        catch (err) {
+            if (err instanceof FreematicaError)
+                return error(err);
+            return error(err instanceof Error ? err : new Error(String(err)));
+        }
+    });
+    if (!opts.enableWrites)
+        return;
+    server.tool(CREATE_TOOL_NAME, CREATE_DESCRIPTION, CreateContratoShape, { readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: true }, async (args) => {
+        try {
+            const body = buildContratoBody(args);
+            const created = await client.createContrato(body);
+            return ok(created);
+        }
+        catch (err) {
+            if (err instanceof FreematicaError)
+                return error(err);
+            return error(err instanceof Error ? err : new Error(String(err)));
+        }
+    });
+    server.tool(UPDATE_TOOL_NAME, UPDATE_DESCRIPTION, UpdateContratoShape, { readOnlyHint: false, destructiveHint: true, idempotentHint: true, openWorldHint: true }, async ({ idReg, ...fields }) => {
+        try {
+            const body = buildContratoBody(fields);
+            if (Object.keys(body).length === 0) {
+                return error(new Error('Debes informar al menos un campo a actualizar además de idReg.'));
+            }
+            const updated = await client.updateContrato(idReg, body);
+            return ok(updated);
+        }
+        catch (err) {
+            if (err instanceof FreematicaError)
+                return error(err);
+            return error(err instanceof Error ? err : new Error(String(err)));
+        }
+    });
+}
+//# sourceMappingURL=cabecera.js.map

package/dist/tools/contratos/cabecera.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cabecera.js","sourceRoot":"","sources":["../../../src/tools/contratos/cabecera.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAE/D,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAC/D,OAAO,EACL,mBAAmB,EACnB,mBAAmB,EACnB,iBAAiB,GAElB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAElD,MAAM,cAAc,GAAG,2BAA2B,CAAC;AACnD,MAAM,aAAa,GAAG,yBAAyB,CAAC;AAChD,MAAM,gBAAgB,GAAG,4BAA4B,CAAC;AACtD,MAAM,gBAAgB,GAAG,4BAA4B,CAAC;AAEtD,MAAM,gBAAgB,GAAG;IACvB,sFAAsF;IACtF,EAAE;IACF,4EAA4E;IAC5E,sEAAsE;IACtE,8EAA8E;IAC9E,8BAA8B;IAC9B,EAAE;IACF,0EAA0E;IAC1E,yEAAyE;IACzE,kEAAkE;CACnE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAEb,MAAM,eAAe,GAAG;IACtB,4EAA4E;IAC5E,yCAAyC;IACzC,EAAE;IACF,6EAA6E;IAC7E,2EAA2E;IAC3E,+EAA+E;IAC/E,4CAA4C;CAC7C,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAEb,MAAM,kBAAkB,GAAG;IACzB,qEAAqE;IACrE,EAAE;IACF,uDAAuD;IACvD,mEAAmE;IACnE,4EAA4E;IAC5E,EAAE;IACF,4EAA4E;IAC5E,8EAA8E;IAC9E,iDAAiD;CAClD,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAEb,MAAM,kBAAkB,GAAG;IACzB,iDAAiD;IACjD,EAAE;IACF,8DAA8D;IAC9D,8EAA8E;IAC9E,0EAA0E;CAC3E,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAMb,qFAAqF;AACrF,MAAM,UAAU,qBAAqB,CACnC,MAAiB,EACjB,MAAwB,EACxB,IAAqB;IAErB,MAAM,CAAC,IAAI,CACT,cAAc,EACd,gBAAgB,EAChB;QACE,GAAG,gBAAgB;QACnB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,8CAA8C,CAAC;QAC9F,UAAU,EAAE,CAAC;aACV,MAAM,EAAE;aACR,GAAG,CAAC,CAAC,CAAC;aACN,QAAQ,EAAE;aACV,QAAQ,CAAC,oDAAoD,CAAC;QACjE,KAAK,EAAE,CAAC;aACL,MAAM,EAAE;aACR,QAAQ,EAAE;aACV,QAAQ,CAAC,qDAAqD,CAAC;KACnE,EACD,EAAE,YAAY,EAAE,IAAI,EAAE,eAAe,EAAE,KAAK,EAAE,aAAa,EAAE,IAAI,EAAE,EACnE,KAAK,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,EAA2B,EAAE;QAC7E,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,aAAa,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC,CAAC;YACvF,OAAO,MAAM,CAAC;gBACZ,KAAK,EAAE,MAAM,CAAC,KAAK;gBACnB,KAAK,EAAE,MAAM,CAAC,KAAK;gBACnB,IAAI;gBACJ,YAAY,EAAE,KAAK;aACpB,CAAmB,CAAC;QACvB,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,MAAM,CAAC,IAAI,CACT,aAAa,EACb,eAAe,EACf;QACE,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,yCAAyC,CAAC;QAC9E,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,6CAA6C,CAAC;QACvF,UAAU,EAAE,CAAC;aACV,MAAM,EAAE;aACR,GAAG,CAAC,CAAC,CAAC;aACN,QAAQ,EAAE;aACV,QAAQ,CAAC,oEAAoE,CAAC;KAClF,EACD,EAAE,YAAY,EAAE,IAAI,EAAE,eAAe,EAAE,KAAK,EAAE,aAAa,EAAE,IAAI,EAAE,EACnE,KAAK,EAAE,EAAE,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,EAA2B,EAAE;QACtE,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,WAAW,CAAC,EAAE,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,CAAC,CAAC;YAChF,OAAO,EAAE,CAAC,QAAQ,CAAmB,CAAC;QACxC,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,IAAI,CAAC,IAAI,CAAC,YAAY;QAAE,OAAO;IAE/B,MAAM,CAAC,IAAI,CACT,gBAAgB,EAChB,kBAAkB,EAClB,mBAAmB,EACnB,EAAE,YAAY,EAAE,KAAK,EAAE,eAAe,EAAE,KAAK,EAAE,cAAc,EAAE,KAAK,EAAE,aAAa,EAAE,IAAI,EAAE,EAC3F,KAAK,EAAE,IAAI,EAA2B,EAAE;QACtC,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,iBAAiB,CAAC,IAAsB,CAAC,CAAC;YACvD,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC;YAClD,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,MAAM,CAAC,IAAI,CACT,gBAAgB,EAChB,kBAAkB,EAClB,mBAAmB,EACnB,EAAE,YAAY,EAAE,KAAK,EAAE,eAAe,EAAE,IAAI,EAAE,cAAc,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,EACzF,KAAK,EAAE,EAAE,KAAK,EAAE,GAAG,MAAM,EAAE,EAA2B,EAAE;QACtD,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,iBAAiB,CAAC,MAAwB,CAAC,CAAC;YACzD,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACnC,OAAO,KAAK,CACV,IAAI,KAAK,CAAC,gEAAgE,CAAC,CAC1D,CAAC;YACtB,CAAC;YACD,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,cAAc,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;YACzD,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;AACJ,CAAC"}

package/dist/tools/contratos/index.d.ts

@@ -0,0 +1,21 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { FreematicaClient } from '../../clients/freematica-client.js';
+import { type RegisterOptions } from './cabecera.js';
+/**
+ * Registra las tools MCP del grupo "Contratos y Servicios" (módulos pvss y ppre).
+ *
+ * Lectura (siempre registradas):
+ *   - freematica_list_contratos / freematica_get_contrato
+ *   - freematica_list_servicios_contrato / freematica_get_servicio_contrato
+ *   - freematica_list_contratos_opcionales / freematica_get_contrato_opcionales
+ *   - freematica_list_materiales_asignados_servicios
+ *
+ * Escritura (solo si FREEMATICA_ENABLE_WRITES=true; nunca hay delete):
+ *   - freematica_create_contrato / freematica_update_contrato
+ *   - freematica_create_servicio_contrato / freematica_update_servicio_fechas
+ *   - freematica_create_servicio_historico_precios / freematica_update_servicio_historico_precios
+ *   - freematica_create_servicio_facturacion_txt / freematica_update_servicio_facturacion
+ *   - freematica_create_contrato_opcionales / freematica_update_contrato_opcionales
+ */
+export declare function registerContratosTools(server: McpServer, client: FreematicaClient, opts?: RegisterOptions): void;
+export type { RegisterOptions } from './cabecera.js';

package/dist/tools/contratos/index.js

@@ -0,0 +1,31 @@
+import { logger } from '../../logger.js';
+import { registerCabeceraTools } from './cabecera.js';
+import { registerMaterialesTools } from './materiales.js';
+import { registerOpcionalesTools } from './opcionales.js';
+import { registerServiciosTools } from './servicios.js';
+/**
+ * Registra las tools MCP del grupo "Contratos y Servicios" (módulos pvss y ppre).
+ *
+ * Lectura (siempre registradas):
+ *   - freematica_list_contratos / freematica_get_contrato
+ *   - freematica_list_servicios_contrato / freematica_get_servicio_contrato
+ *   - freematica_list_contratos_opcionales / freematica_get_contrato_opcionales
+ *   - freematica_list_materiales_asignados_servicios
+ *
+ * Escritura (solo si FREEMATICA_ENABLE_WRITES=true; nunca hay delete):
+ *   - freematica_create_contrato / freematica_update_contrato
+ *   - freematica_create_servicio_contrato / freematica_update_servicio_fechas
+ *   - freematica_create_servicio_historico_precios / freematica_update_servicio_historico_precios
+ *   - freematica_create_servicio_facturacion_txt / freematica_update_servicio_facturacion
+ *   - freematica_create_contrato_opcionales / freematica_update_contrato_opcionales
+ */
+export function registerContratosTools(server, client, opts = { enableWrites: false }) {
+    registerMaterialesTools(server, client);
+    registerCabeceraTools(server, client, opts);
+    registerServiciosTools(server, client, opts);
+    registerOpcionalesTools(server, client, opts);
+    if (opts.enableWrites) {
+        logger.warn('FREEMATICA_ENABLE_WRITES=true: tools de escritura de contratos registradas (create/update, sin delete)');
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/tools/contratos/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/tools/contratos/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AACzC,OAAO,EAAE,qBAAqB,EAAwB,MAAM,eAAe,CAAC;AAC5E,OAAO,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AAC1D,OAAO,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AAC1D,OAAO,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AAExD;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,sBAAsB,CACpC,MAAiB,EACjB,MAAwB,EACxB,OAAwB,EAAE,YAAY,EAAE,KAAK,EAAE;IAE/C,uBAAuB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACxC,qBAAqB,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC;IAC5C,sBAAsB,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC;IAC7C,uBAAuB,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC;IAE9C,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;QACtB,MAAM,CAAC,IAAI,CACT,wGAAwG,CACzG,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/tools/contratos/materiales.d.ts

@@ -0,0 +1,4 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { FreematicaClient } from '../../clients/freematica-client.js';
+/** Tools de material asignado a servicios (solo lectura). */
+export declare function registerMaterialesTools(server: McpServer, client: FreematicaClient): void;

package/dist/tools/{contratos.js → contratos/materiales.js}

@@ -1,5 +1,5 @@
-import { FreematicaError } from '../clients/base-client.js';
-import { error, okList } from './helpers.js';
+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.',
@@ -12,14 +12,8 @@ const LIST_MATERIALES_TOOL_DESCRIPTION = [
     '  - 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) {
+/** Tools de material asignado a servicios (solo lectura). */
+export function registerMaterialesTools(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();
@@ -32,4 +26,4 @@ export function registerContratosTools(server, client) {
         }
     });
 }
-//# sourceMappingURL=contratos.js.map
+//# sourceMappingURL=materiales.js.map

package/dist/tools/contratos/materiales.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"materiales.js","sourceRoot":"","sources":["../../../src/tools/contratos/materiales.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAE/D,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAE9C,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,6DAA6D;AAC7D,MAAM,UAAU,uBAAuB,CAAC,MAAiB,EAAE,MAAwB;IACjF,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/contratos/opcionales.d.ts

@@ -0,0 +1,5 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { FreematicaClient } from '../../clients/freematica-client.js';
+import type { RegisterOptions } from './cabecera.js';
+/** Tools de opcionales de contrato: list/get (lectura) + create/update (escritura). */
+export declare function registerOpcionalesTools(server: McpServer, client: FreematicaClient, opts: RegisterOptions): void;

package/dist/tools/contratos/opcionales.js

@@ -0,0 +1,106 @@
+import { z } from 'zod';
+import { FreematicaError } from '../../clients/base-client.js';
+import { PaginationSchema } from '../../schemas/pagination.js';
+import { CreateContratoOpcionalesShape, UpdateContratoOpcionalesShape, buildContratoOpcionalesBody, } from '../../schemas/contratos.js';
+import { error, ok, okList } from '../helpers.js';
+const LIST_TOOL_NAME = 'freematica_list_contratos_opcionales';
+const GET_TOOL_NAME = 'freematica_get_contrato_opcionales';
+const CREATE_TOOL_NAME = 'freematica_create_contrato_opcionales';
+const UPDATE_TOOL_NAME = 'freematica_update_contrato_opcionales';
+const LIST_DESCRIPTION = [
+    'Devuelve la lista paginada de registros de opcionales de contratos',
+    '(módulo Presupuestos y Contratos, ppre).',
+    '',
+    'Endpoint: GET /ppre/v2/contratos/opcionales. Cada item tiene campos CON2_*',
+    '(10 numéricos y 10 alfanuméricos de propósito libre, descuentos, garantías,',
+    'observaciones) más `idReg` opaco para el resto de tools de opcionales.',
+].join('\n');
+const GET_DESCRIPTION = [
+    'Devuelve el detalle de un registro de opcionales de contrato.',
+    '',
+    'Endpoint: GET /ppre/v2/contratos/opcionales/{idReg}.',
+    '`idReg` es el identificador opaco (campo "idReg" en los items de',
+    'freematica_list_contratos_opcionales).',
+].join('\n');
+const CREATE_DESCRIPTION = [
+    'Da de alta un registro de opcionales de contrato.',
+    '',
+    'Endpoint: POST /ppre/v2/contratos/opcionales — body VoContratosOpcionales.',
+    'Requeridos: empresa, delegacion, tipoContrato, numContrato, fechaContrato.',
+    'Los campos flexibles (CON2_OPC_NUM1..10, CON2_OPC_ALFA1..10, descuentos,',
+    'garantías) se pasan en camposAdicionales con su nombre nativo CON2_*.',
+].join('\n');
+const UPDATE_DESCRIPTION = [
+    'Actualiza un registro de opcionales de contrato existente.',
+    '',
+    'Endpoint: PUT /ppre/v2/contratos/opcionales/{idReg}.',
+    'Solo se envían al API los campos informados.',
+].join('\n');
+/** Tools de opcionales de contrato: list/get (lectura) + create/update (escritura). */
+export function registerOpcionalesTools(server, client, opts) {
+    server.tool(LIST_TOOL_NAME, LIST_DESCRIPTION, {
+        ...PaginationSchema,
+        order: z.string().optional().describe('Orden de los registros. Ejemplo: "CON2_FCHCONT desc".'),
+    }, { readOnlyHint: true, destructiveHint: false, openWorldHint: true }, async ({ page, items, order }) => {
+        try {
+            const result = await client.listContratosOpcionales({ page, items, 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)));
+        }
+    });
+    server.tool(GET_TOOL_NAME, GET_DESCRIPTION, {
+        idReg: z
+            .string()
+            .min(1)
+            .describe('idReg opaco del registro (campo "idReg" en freematica_list_contratos_opcionales).'),
+    }, { readOnlyHint: true, destructiveHint: false, openWorldHint: true }, async ({ idReg }) => {
+        try {
+            const registro = await client.getContratoOpcionales(idReg);
+            return ok(registro);
+        }
+        catch (err) {
+            if (err instanceof FreematicaError)
+                return error(err);
+            return error(err instanceof Error ? err : new Error(String(err)));
+        }
+    });
+    if (!opts.enableWrites)
+        return;
+    server.tool(CREATE_TOOL_NAME, CREATE_DESCRIPTION, CreateContratoOpcionalesShape, { readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: true }, async (args) => {
+        try {
+            const body = buildContratoOpcionalesBody(args);
+            const created = await client.createContratoOpcionales(body);
+            return ok(created);
+        }
+        catch (err) {
+            if (err instanceof FreematicaError)
+                return error(err);
+            return error(err instanceof Error ? err : new Error(String(err)));
+        }
+    });
+    server.tool(UPDATE_TOOL_NAME, UPDATE_DESCRIPTION, UpdateContratoOpcionalesShape, { readOnlyHint: false, destructiveHint: true, idempotentHint: true, openWorldHint: true }, async ({ idReg, ...fields }) => {
+        try {
+            const body = buildContratoOpcionalesBody(fields);
+            if (Object.keys(body).length === 0) {
+                return error(new Error('Debes informar al menos un campo a actualizar además de idReg.'));
+            }
+            const updated = await client.updateContratoOpcionales(idReg, body);
+            return ok(updated);
+        }
+        catch (err) {
+            if (err instanceof FreematicaError)
+                return error(err);
+            return error(err instanceof Error ? err : new Error(String(err)));
+        }
+    });
+}
+//# sourceMappingURL=opcionales.js.map

package/dist/tools/contratos/opcionales.js.map

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

package/dist/tools/contratos/servicios.d.ts

@@ -0,0 +1,5 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { FreematicaClient } from '../../clients/freematica-client.js';
+import type { RegisterOptions } from './cabecera.js';
+/** Tools de servicios de contrato: list/get (lectura) + create/update (escritura). */
+export declare function registerServiciosTools(server: McpServer, client: FreematicaClient, opts: RegisterOptions): void;

package/dist/tools/contratos/servicios.js

@@ -0,0 +1,215 @@
+import { z } from 'zod';
+import { FreematicaError } from '../../clients/base-client.js';
+import { PaginationSchema } from '../../schemas/pagination.js';
+import { CreateServicioShape, UpdateServicioFechasShape, ServicioHistoricoPreciosShape, CreateServicioFacturacionTxtShape, UpdateServicioFacturacionShape, buildServicioBody, buildHistoricoPreciosBody, buildFacturacionTxtBody, buildServicioFacturacionBody, } from '../../schemas/contratos.js';
+import { decodeContratoIdReg, decodeServicioIdReg } from '../../utils/idreg.js';
+import { error, ok, okList } from '../helpers.js';
+const LIST_TOOL_NAME = 'freematica_list_servicios_contrato';
+const GET_TOOL_NAME = 'freematica_get_servicio_contrato';
+const CREATE_TOOL_NAME = 'freematica_create_servicio_contrato';
+const UPDATE_FECHAS_TOOL_NAME = 'freematica_update_servicio_fechas';
+const CREATE_HIST_TOOL_NAME = 'freematica_create_servicio_historico_precios';
+const UPDATE_HIST_TOOL_NAME = 'freematica_update_servicio_historico_precios';
+const CREATE_FACTXT_TOOL_NAME = 'freematica_create_servicio_facturacion_txt';
+const UPDATE_FAC_TOOL_NAME = 'freematica_update_servicio_facturacion';
+const LIST_DESCRIPTION = [
+    'Devuelve la lista paginada de servicios de un contrato.',
+    '',
+    'Endpoint: GET /pvss/v1/contratos/{idContrato}/servicios.',
+    'Cada item tiene campos CTRTS_* (CTRTS_COD, CTRTS_DES, CTRTS_TIPO,',
+    'CTRTS_FECALTA, CTRTS_FECFIN, CTRTS_CLASE…) más `idReg` opaco',
+    '(Base64 "EMP__DELEG__CTRT__COD") que se usa en las tools de escritura.',
+].join('\n');
+const GET_DESCRIPTION = [
+    'Devuelve el detalle de un servicio de contrato.',
+    '',
+    'Endpoint: GET /pvss/v2/contratos-servicios/{idreg}.',
+    '`idReg` es el identificador opaco del servicio (campo "idReg" en los items',
+    'de freematica_list_servicios_contrato).',
+].join('\n');
+const CREATE_DESCRIPTION = [
+    'Da de alta un servicio en un contrato existente (Alta servicio de Cuadrantes).',
+    '',
+    'Endpoint: POST /pvss/v2/contratos/{idReg}/servicios — body VoServicios.',
+    'Los campos requeridos por el API (empresa, delegación, código de contrato)',
+    'se derivan automáticamente del idContrato; solo hay que pasar los datos del',
+    'servicio. Si no se informa codServicio, lo asigna Freemática.',
+    '',
+    'NOTA: los precios del servicio NO van aquí; usa',
+    'freematica_create_servicio_historico_precios tras crear el servicio.',
+].join('\n');
+const UPDATE_FECHAS_DESCRIPTION = [
+    'Actualiza las fechas de inicio y/o fin de un servicio de contrato.',
+    '',
+    'Endpoint: PUT /pvss/v2/contratos/{idContrato}/servicio/{idServicio}.',
+    'Según el spec del API, este endpoint SOLO actualiza fecha inicio y fecha fin.',
+    'Informar fechaFin es la forma estándar de dar de baja un servicio (no existe',
+    'DELETE en el API).',
+].join('\n');
+const CREATE_HIST_DESCRIPTION = [
+    'Da de alta un registro de histórico de precios de un servicio.',
+    '',
+    'Endpoint: POST /pvss/v2/contratos/{idContrato}/servicios-historico-precios/{idServicio}.',
+    'Los precios de un servicio se gestionan como histórico versionado: cada alta',
+    'añade una revisión (precio hora global/diurna/nocturna/festiva, importe fijo,',
+    '% de incremento). Los campos de identificación se derivan de los idReg.',
+].join('\n');
+const UPDATE_HIST_DESCRIPTION = [
+    'Actualiza un registro de histórico de precios de un servicio.',
+    '',
+    'Endpoint: PUT /pvss/v2/contratos/{idContrato}/servicios-historico-precios/{idServicio}.',
+].join('\n');
+const CREATE_FACTXT_DESCRIPTION = [
+    'Da de alta una línea de texto de facturación de un servicio.',
+    '',
+    'Endpoint: POST /pvss/v2/contratos/{idContrato}/servicios-facturacion-txt/{idServicio}.',
+    'Los textos aparecen en las líneas de factura del servicio. Requerido: linea',
+    '(código de línea, 4c). Los campos de identificación se derivan de los idReg.',
+].join('\n');
+const UPDATE_FAC_DESCRIPTION = [
+    'Actualiza los datos de facturación de un servicio (precios hora, importe,',
+    'forma de pago, clave de facturación…).',
+    '',
+    'Endpoint: PUT /pvss/v2/contratos/{idContrato}/servicios-facturacion/{idServicio}.',
+    'Los campos más comunes tienen parámetro propio; el resto de los 42 campos',
+    'VoServiciosFac puede pasarse en camposAdicionales con su nombre nativo CTRTF_*.',
+].join('\n');
+/** Tools de servicios de contrato: list/get (lectura) + create/update (escritura). */
+export function registerServiciosTools(server, client, opts) {
+    server.tool(LIST_TOOL_NAME, LIST_DESCRIPTION, {
+        idContrato: z
+            .string()
+            .min(1)
+            .describe('idReg opaco del contrato (campo "idReg" en freematica_list_contratos).'),
+        ...PaginationSchema,
+        order: z.string().optional().describe('Orden de los registros. Ejemplo: "CTRTS_COD asc".'),
+    }, { readOnlyHint: true, destructiveHint: false, openWorldHint: true }, async ({ idContrato, page, items, order }) => {
+        try {
+            const result = await client.listServiciosContrato(idContrato, { page, items, 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)));
+        }
+    });
+    server.tool(GET_TOOL_NAME, GET_DESCRIPTION, {
+        idReg: z
+            .string()
+            .min(1)
+            .describe('idReg opaco del servicio (campo "idReg" en freematica_list_servicios_contrato).'),
+    }, { readOnlyHint: true, destructiveHint: false, openWorldHint: true }, async ({ idReg }) => {
+        try {
+            const servicio = await client.getServicioContrato(idReg);
+            return ok(servicio);
+        }
+        catch (err) {
+            if (err instanceof FreematicaError)
+                return error(err);
+            return error(err instanceof Error ? err : new Error(String(err)));
+        }
+    });
+    if (!opts.enableWrites)
+        return;
+    server.tool(CREATE_TOOL_NAME, CREATE_DESCRIPTION, CreateServicioShape, { readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: true }, async ({ idContrato, ...fields }) => {
+        try {
+            const parts = decodeContratoIdReg(idContrato);
+            const body = buildServicioBody(parts, fields);
+            const created = await client.createServicioContrato(idContrato, body);
+            return ok(created);
+        }
+        catch (err) {
+            if (err instanceof FreematicaError)
+                return error(err);
+            return error(err instanceof Error ? err : new Error(String(err)));
+        }
+    });
+    server.tool(UPDATE_FECHAS_TOOL_NAME, UPDATE_FECHAS_DESCRIPTION, UpdateServicioFechasShape, { readOnlyHint: false, destructiveHint: true, idempotentHint: true, openWorldHint: true }, async ({ idContrato, idServicio, fechaAlta, fechaFin }) => {
+        try {
+            if (fechaAlta === undefined && fechaFin === undefined) {
+                return error(new Error('Debes informar fechaAlta y/o fechaFin.'));
+            }
+            const parts = decodeServicioIdReg(idServicio);
+            const body = {
+                CTRTS_EMP: parts.empresa,
+                CTRTS_DELEG: parts.delegacion,
+                CTRTS_CTRT: parts.codContrato,
+                CTRTS_COD: parts.codServicio,
+            };
+            if (fechaAlta !== undefined)
+                body['CTRTS_FECALTA'] = fechaAlta;
+            if (fechaFin !== undefined)
+                body['CTRTS_FECFIN'] = fechaFin;
+            const updated = await client.updateServicioFechas(idContrato, idServicio, body);
+            return ok(updated);
+        }
+        catch (err) {
+            if (err instanceof FreematicaError)
+                return error(err);
+            return error(err instanceof Error ? err : new Error(String(err)));
+        }
+    });
+    server.tool(CREATE_HIST_TOOL_NAME, CREATE_HIST_DESCRIPTION, ServicioHistoricoPreciosShape, { readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: true }, async ({ idContrato, idServicio, ...fields }) => {
+        try {
+            const parts = decodeServicioIdReg(idServicio);
+            const body = buildHistoricoPreciosBody(parts, fields);
+            const created = await client.createServicioHistoricoPrecios(idContrato, idServicio, body);
+            return ok(created);
+        }
+        catch (err) {
+            if (err instanceof FreematicaError)
+                return error(err);
+            return error(err instanceof Error ? err : new Error(String(err)));
+        }
+    });
+    server.tool(UPDATE_HIST_TOOL_NAME, UPDATE_HIST_DESCRIPTION, ServicioHistoricoPreciosShape, { readOnlyHint: false, destructiveHint: true, idempotentHint: true, openWorldHint: true }, async ({ idContrato, idServicio, ...fields }) => {
+        try {
+            const parts = decodeServicioIdReg(idServicio);
+            const body = buildHistoricoPreciosBody(parts, fields);
+            const updated = await client.updateServicioHistoricoPrecios(idContrato, idServicio, body);
+            return ok(updated);
+        }
+        catch (err) {
+            if (err instanceof FreematicaError)
+                return error(err);
+            return error(err instanceof Error ? err : new Error(String(err)));
+        }
+    });
+    server.tool(CREATE_FACTXT_TOOL_NAME, CREATE_FACTXT_DESCRIPTION, CreateServicioFacturacionTxtShape, { readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: true }, async ({ idContrato, idServicio, linea, texto, textoAmpliado }) => {
+        try {
+            const parts = decodeServicioIdReg(idServicio);
+            const body = buildFacturacionTxtBody(parts, { linea, texto, textoAmpliado });
+            const created = await client.createServicioFacturacionTxt(idContrato, idServicio, body);
+            return ok(created);
+        }
+        catch (err) {
+            if (err instanceof FreematicaError)
+                return error(err);
+            return error(err instanceof Error ? err : new Error(String(err)));
+        }
+    });
+    server.tool(UPDATE_FAC_TOOL_NAME, UPDATE_FAC_DESCRIPTION, UpdateServicioFacturacionShape, { readOnlyHint: false, destructiveHint: true, idempotentHint: true, openWorldHint: true }, async ({ idContrato, idServicio, ...fields }) => {
+        try {
+            const parts = decodeServicioIdReg(idServicio);
+            const body = buildServicioFacturacionBody(parts, fields);
+            // 4 claves de identificación siempre presentes; exigir al menos un dato más
+            if (Object.keys(body).length <= 4) {
+                return error(new Error('Debes informar al menos un campo de facturación a actualizar.'));
+            }
+            const updated = await client.updateServicioFacturacion(idContrato, idServicio, body);
+            return ok(updated);
+        }
+        catch (err) {
+            if (err instanceof FreematicaError)
+                return error(err);
+            return error(err instanceof Error ? err : new Error(String(err)));
+        }
+    });
+}
+//# sourceMappingURL=servicios.js.map

package/dist/tools/contratos/servicios.js.map

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

package/dist/transports/http.d.ts

@@ -4,6 +4,8 @@ export interface HttpTransportConfig {
     port: number;
     client: FreematicaClient;
     allowedOrigins: string;
+    /** Override del flag de escrituras; si se omite se lee FREEMATICA_ENABLE_WRITES. */
+    enableWrites?: boolean;
 }
 export interface HttpAppResult {
     app: express.Application;

package/dist/transports/http.js

@@ -4,6 +4,7 @@ import rateLimit from 'express-rate-limit';
 import { randomUUID } from 'node:crypto';
 import { StreamableHTTPServerTransport } from '@modelcontextprotocol/sdk/server/streamableHttp.js';
 import { isInitializeRequest } from '@modelcontextprotocol/sdk/types.js';
+import { loadWritesConfig } from '../config.js';
 import { createFreematicaServer } from '../server.js';
 import { VERSION } from '../version.js';
 import { logger } from '../logger.js';
@@ -60,7 +61,8 @@ export async function createHttpApp(config) {
                 if (transport.sessionId)
                     sessions.delete(transport.sessionId);
             };
-            const server = createFreematicaServer({ client: config.client });
+            const enableWrites = config.enableWrites ?? loadWritesConfig().FREEMATICA_ENABLE_WRITES;
+            const server = createFreematicaServer({ client: config.client, enableWrites });
             await server.connect(transport);
             await transport.handleRequest(req, res, req.body);
             return;