@nubiia/mcp-freematica 0.6.1

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

@@ -0,0 +1,118 @@
+import { z } from 'zod';
+/**
+ * Filtros tipados para `freematica_list_facturas_cabecera`.
+ *
+ * Todos los campos son opcionales y se combinan con AND en la FIQL generada
+ * (`rquery`). El campo de paginación hereda de `PaginationSchema`.
+ *
+ * Mapeo de filtros → campos FIQL de Freemática:
+ * | Filtro lógico              | Campo FIQL       |
+ * |----------------------------|------------------|
+ * | empresa                    | FVC_EMP          |
+ * | codCliente                 | FVC_CODAUX       |
+ * | representante              | FVC_CODREP       |
+ * | fechaFacturaDesde          | FVC_FECFAC =ge=  |
+ * | fechaFacturaHasta          | FVC_FECFAC =le=  |
+ * | serie                      | FVC_SERFAC       |
+ * | numFactura                 | FVC_NUMFAC       |
+ * | formaPago                  | FVC_CODFPAG      |
+ * | traspasadoContabilidad     | FVC_TRSCONT      |
+ * | delegacion                 | FVC_DELEG        |
+ */
+export declare const ListFacturasCabeceraFiltersSchema: {
+    empresa: z.ZodOptional<z.ZodString>;
+    codCliente: z.ZodOptional<z.ZodString>;
+    representante: z.ZodOptional<z.ZodString>;
+    fechaFacturaDesde: z.ZodOptional<z.ZodString>;
+    fechaFacturaHasta: z.ZodOptional<z.ZodString>;
+    serie: z.ZodOptional<z.ZodString>;
+    numFactura: z.ZodOptional<z.ZodString>;
+    formaPago: z.ZodOptional<z.ZodString>;
+    traspasadoContabilidad: z.ZodOptional<z.ZodBoolean>;
+    delegacion: z.ZodOptional<z.ZodString>;
+    page: z.ZodDefault<z.ZodNumber>;
+    items: z.ZodDefault<z.ZodNumber>;
+};
+export type ListFacturasCabeceraFilters = {
+    page?: number;
+    items?: number;
+    empresa?: string;
+    codCliente?: string;
+    representante?: string;
+    fechaFacturaDesde?: string;
+    fechaFacturaHasta?: string;
+    serie?: string;
+    numFactura?: string;
+    formaPago?: string;
+    traspasadoContabilidad?: boolean;
+    delegacion?: string;
+};
+/**
+ * Filtros tipados para `freematica_list_factura_lineas`.
+ *
+ * Mapeo de filtros → campos FIQL de Freemática (prefijo `FVL_`):
+ * | Filtro lógico  | Campo FIQL       |
+ * |----------------|------------------|
+ * | codArticulo    | FVL_CODART       |
+ * | codFamilia     | FVL_CODFAM       |
+ * | codSubfamilia  | FVL_CODSFAM      |
+ * | delegacion     | FVL_DELEG        |
+ */
+export declare const ListFacturaLineasFiltersSchema: {
+    codArticulo: z.ZodOptional<z.ZodString>;
+    codFamilia: z.ZodOptional<z.ZodString>;
+    codSubfamilia: z.ZodOptional<z.ZodString>;
+    delegacion: z.ZodOptional<z.ZodString>;
+    page: z.ZodDefault<z.ZodNumber>;
+    items: z.ZodDefault<z.ZodNumber>;
+};
+export type ListFacturaLineasFilters = {
+    page?: number;
+    items?: number;
+    codArticulo?: string;
+    codFamilia?: string;
+    codSubfamilia?: string;
+    delegacion?: string;
+};
+/**
+ * Filtros tipados para `freematica_list_factura_iva`.
+ *
+ * Mapeo de filtros → campos FIQL de Freemática (prefijo `FVI_`):
+ * | Filtro lógico  | Campo FIQL  |
+ * |----------------|-------------|
+ * | tipoIva        | FVI_TIPIVA  |
+ */
+export declare const ListFacturaIvaFiltersSchema: {
+    tipoIva: z.ZodOptional<z.ZodString>;
+    page: z.ZodDefault<z.ZodNumber>;
+    items: z.ZodDefault<z.ZodNumber>;
+};
+export type ListFacturaIvaFilters = {
+    page?: number;
+    items?: number;
+    tipoIva?: string;
+};
+/**
+ * Filtros tipados para `freematica_list_factura_vencimientos`.
+ *
+ * Mapeo de filtros → campos FIQL de Freemática (prefijo `FVV_`):
+ * | Filtro lógico             | Campo FIQL       |
+ * |---------------------------|------------------|
+ * | fechaVencimientoDesde     | FVV_FECVCTO =ge= |
+ * | fechaVencimientoHasta     | FVV_FECVCTO =le= |
+ * | modoPago                  | FVV_CODMPAG      |
+ */
+export declare const ListFacturaVencimientosFiltersSchema: {
+    fechaVencimientoDesde: z.ZodOptional<z.ZodString>;
+    fechaVencimientoHasta: z.ZodOptional<z.ZodString>;
+    modoPago: z.ZodOptional<z.ZodString>;
+    page: z.ZodDefault<z.ZodNumber>;
+    items: z.ZodDefault<z.ZodNumber>;
+};
+export type ListFacturaVencimientosFilters = {
+    page?: number;
+    items?: number;
+    fechaVencimientoDesde?: string;
+    fechaVencimientoHasta?: string;
+    modoPago?: string;
+};

package/dist/schemas/facturas-ventas.js

@@ -0,0 +1,153 @@
+import { z } from 'zod';
+import { PaginationSchema } from './pagination.js';
+/**
+ * Filtros tipados para `freematica_list_facturas_cabecera`.
+ *
+ * Todos los campos son opcionales y se combinan con AND en la FIQL generada
+ * (`rquery`). El campo de paginación hereda de `PaginationSchema`.
+ *
+ * Mapeo de filtros → campos FIQL de Freemática:
+ * | Filtro lógico              | Campo FIQL       |
+ * |----------------------------|------------------|
+ * | empresa                    | FVC_EMP          |
+ * | codCliente                 | FVC_CODAUX       |
+ * | representante              | FVC_CODREP       |
+ * | fechaFacturaDesde          | FVC_FECFAC =ge=  |
+ * | fechaFacturaHasta          | FVC_FECFAC =le=  |
+ * | serie                      | FVC_SERFAC       |
+ * | numFactura                 | FVC_NUMFAC       |
+ * | formaPago                  | FVC_CODFPAG      |
+ * | traspasadoContabilidad     | FVC_TRSCONT      |
+ * | delegacion                 | FVC_DELEG        |
+ */
+export const ListFacturasCabeceraFiltersSchema = {
+    ...PaginationSchema,
+    empresa: z
+        .string()
+        .min(1)
+        .optional()
+        .describe('Código de empresa Freemática (FVC_EMP). Ej.: "1".'),
+    codCliente: z
+        .string()
+        .min(1)
+        .optional()
+        .describe('Código natural del cliente facturado (FVC_CODAUX).'),
+    representante: z
+        .string()
+        .min(1)
+        .optional()
+        .describe('Código del representante/comercial (FVC_CODREP).'),
+    fechaFacturaDesde: z
+        .string()
+        .regex(/^\d{4}-\d{2}-\d{2}$/, 'Debe ser una fecha en formato ISO 8601 YYYY-MM-DD')
+        .optional()
+        .describe('Fecha inicio de la factura (FVC_FECFAC). Formato YYYY-MM-DD. Inclusive.'),
+    fechaFacturaHasta: z
+        .string()
+        .regex(/^\d{4}-\d{2}-\d{2}$/, 'Debe ser una fecha en formato ISO 8601 YYYY-MM-DD')
+        .optional()
+        .describe('Fecha fin de la factura (FVC_FECFAC). Formato YYYY-MM-DD. Inclusive.'),
+    serie: z
+        .string()
+        .min(1)
+        .optional()
+        .describe('Serie de facturación (FVC_SERFAC). Ej.: "A", "B".'),
+    numFactura: z
+        .string()
+        .min(1)
+        .optional()
+        .describe('Número de factura exacto (FVC_NUMFAC).'),
+    formaPago: z
+        .string()
+        .min(1)
+        .optional()
+        .describe('Código de forma de pago (FVC_CODFPAG). Ej.: "REC", "TRF".'),
+    traspasadoContabilidad: z
+        .boolean()
+        .optional()
+        .describe('Si true, filtra facturas ya traspasadas a contabilidad (FVC_TRSCONT). Si false, las no traspasadas.'),
+    delegacion: z
+        .string()
+        .min(1)
+        .optional()
+        .describe('Código de delegación (FVC_DELEG).'),
+};
+/**
+ * Filtros tipados para `freematica_list_factura_lineas`.
+ *
+ * Mapeo de filtros → campos FIQL de Freemática (prefijo `FVL_`):
+ * | Filtro lógico  | Campo FIQL       |
+ * |----------------|------------------|
+ * | codArticulo    | FVL_CODART       |
+ * | codFamilia     | FVL_CODFAM       |
+ * | codSubfamilia  | FVL_CODSFAM      |
+ * | delegacion     | FVL_DELEG        |
+ */
+export const ListFacturaLineasFiltersSchema = {
+    ...PaginationSchema,
+    codArticulo: z
+        .string()
+        .min(1)
+        .optional()
+        .describe('Código de artículo (FVL_CODART).'),
+    codFamilia: z
+        .string()
+        .min(1)
+        .optional()
+        .describe('Código de familia de artículo (FVL_CODFAM).'),
+    codSubfamilia: z
+        .string()
+        .min(1)
+        .optional()
+        .describe('Código de subfamilia de artículo (FVL_CODSFAM).'),
+    delegacion: z
+        .string()
+        .min(1)
+        .optional()
+        .describe('Código de delegación (FVL_DELEG).'),
+};
+/**
+ * Filtros tipados para `freematica_list_factura_iva`.
+ *
+ * Mapeo de filtros → campos FIQL de Freemática (prefijo `FVI_`):
+ * | Filtro lógico  | Campo FIQL  |
+ * |----------------|-------------|
+ * | tipoIva        | FVI_TIPIVA  |
+ */
+export const ListFacturaIvaFiltersSchema = {
+    ...PaginationSchema,
+    tipoIva: z
+        .string()
+        .min(1)
+        .optional()
+        .describe('Tipo de IVA (FVI_TIPIVA). Ej.: "21", "10", "4".'),
+};
+/**
+ * Filtros tipados para `freematica_list_factura_vencimientos`.
+ *
+ * Mapeo de filtros → campos FIQL de Freemática (prefijo `FVV_`):
+ * | Filtro lógico             | Campo FIQL       |
+ * |---------------------------|------------------|
+ * | fechaVencimientoDesde     | FVV_FECVCTO =ge= |
+ * | fechaVencimientoHasta     | FVV_FECVCTO =le= |
+ * | modoPago                  | FVV_CODMPAG      |
+ */
+export const ListFacturaVencimientosFiltersSchema = {
+    ...PaginationSchema,
+    fechaVencimientoDesde: z
+        .string()
+        .regex(/^\d{4}-\d{2}-\d{2}$/, 'Debe ser una fecha en formato ISO 8601 YYYY-MM-DD')
+        .optional()
+        .describe('Fecha inicio de vencimiento (FVV_FECVCTO). Formato YYYY-MM-DD. Inclusive.'),
+    fechaVencimientoHasta: z
+        .string()
+        .regex(/^\d{4}-\d{2}-\d{2}$/, 'Debe ser una fecha en formato ISO 8601 YYYY-MM-DD')
+        .optional()
+        .describe('Fecha fin de vencimiento (FVV_FECVCTO). Formato YYYY-MM-DD. Inclusive.'),
+    modoPago: z
+        .string()
+        .min(1)
+        .optional()
+        .describe('Código de modo de pago (FVV_CODMPAG). Ej.: "TRF", "CHQ".'),
+};
+//# sourceMappingURL=facturas-ventas.js.map

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

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

package/dist/schemas/filters.d.ts

@@ -0,0 +1,92 @@
+import { z } from 'zod';
+/**
+ * Rango de fechas opcional en formato ISO 8601 (YYYY-MM-DD o ISO datetime).
+ *
+ * Ambos extremos son opcionales: se puede usar sólo `fechaDesde`, sólo
+ * `fechaHasta`, o ambos para un rango cerrado.
+ *
+ * @example
+ * // Sólo desde:
+ * { fechaDesde: '2024-01-01' }
+ * // Rango cerrado:
+ * { fechaDesde: '2024-01-01', fechaHasta: '2024-12-31' }
+ */
+export declare const DateRangeSchema: z.ZodObject<{
+    fechaDesde: z.ZodOptional<z.ZodString>;
+    fechaHasta: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    fechaDesde?: string | undefined;
+    fechaHasta?: string | undefined;
+}, {
+    fechaDesde?: string | undefined;
+    fechaHasta?: string | undefined;
+}>;
+export type DateRange = z.infer<typeof DateRangeSchema>;
+/**
+ * Filtros de identidad para entidades de Freemática.
+ *
+ * Permite filtrar por cliente, grupo de clientes, proveedor o grupo de
+ * proveedores. Todos los campos son opcionales y se combinan con AND cuando
+ * se usan junto con `BaseFiltersSchema`.
+ *
+ * Los códigos deben ser los códigos naturales del API de Freemática (ej.
+ * `COD_CLI`, `GRUPO_CLI`, `COD_PRO`, `GRUPO_PRO`).
+ */
+export declare const IdentityFiltersSchema: z.ZodObject<{
+    codCliente: z.ZodOptional<z.ZodString>;
+    grupoCliente: z.ZodOptional<z.ZodString>;
+    codProveedor: z.ZodOptional<z.ZodString>;
+    grupoProveedor: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    codProveedor?: string | undefined;
+    codCliente?: string | undefined;
+    grupoCliente?: string | undefined;
+    grupoProveedor?: string | undefined;
+}, {
+    codProveedor?: string | undefined;
+    codCliente?: string | undefined;
+    grupoCliente?: string | undefined;
+    grupoProveedor?: string | undefined;
+}>;
+export type IdentityFilters = z.infer<typeof IdentityFiltersSchema>;
+/**
+ * Schema base para tools que necesitan paginación + rango de fechas + filtros
+ * de identidad.
+ *
+ * Combina `PaginationSchema` + `DateRangeSchema` + `IdentityFiltersSchema`
+ * para que las tools que necesiten filtros tengan un único punto de importación.
+ *
+ * @example
+ * // Usar en el registro de una tool:
+ * import { BaseFiltersSchema } from '../schemas/filters.js';
+ * server.tool('mi_tool', desc, BaseFiltersSchema, ...);
+ */
+export declare const BaseFiltersSchema: z.ZodObject<{
+    codCliente: z.ZodOptional<z.ZodString>;
+    grupoCliente: z.ZodOptional<z.ZodString>;
+    codProveedor: z.ZodOptional<z.ZodString>;
+    grupoProveedor: z.ZodOptional<z.ZodString>;
+    fechaDesde: z.ZodOptional<z.ZodString>;
+    fechaHasta: z.ZodOptional<z.ZodString>;
+    page: z.ZodDefault<z.ZodNumber>;
+    items: z.ZodDefault<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    page: number;
+    items: number;
+    codProveedor?: string | undefined;
+    codCliente?: string | undefined;
+    fechaDesde?: string | undefined;
+    fechaHasta?: string | undefined;
+    grupoCliente?: string | undefined;
+    grupoProveedor?: string | undefined;
+}, {
+    codProveedor?: string | undefined;
+    codCliente?: string | undefined;
+    page?: number | undefined;
+    items?: number | undefined;
+    fechaDesde?: string | undefined;
+    fechaHasta?: string | undefined;
+    grupoCliente?: string | undefined;
+    grupoProveedor?: string | undefined;
+}>;
+export type BaseFilters = z.infer<typeof BaseFiltersSchema>;

package/dist/schemas/filters.js

@@ -0,0 +1,76 @@
+import { z } from 'zod';
+import { PaginationSchema } from './pagination.js';
+/**
+ * Rango de fechas opcional en formato ISO 8601 (YYYY-MM-DD o ISO datetime).
+ *
+ * Ambos extremos son opcionales: se puede usar sólo `fechaDesde`, sólo
+ * `fechaHasta`, o ambos para un rango cerrado.
+ *
+ * @example
+ * // Sólo desde:
+ * { fechaDesde: '2024-01-01' }
+ * // Rango cerrado:
+ * { fechaDesde: '2024-01-01', fechaHasta: '2024-12-31' }
+ */
+export const DateRangeSchema = z.object({
+    fechaDesde: z
+        .string()
+        .regex(/^\d{4}-\d{2}-\d{2}(T\d{2}:\d{2}(:\d{2}(\.\d+)?)?(Z|[+-]\d{2}:\d{2})?)?$/, 'Debe ser una fecha ISO 8601 (YYYY-MM-DD o ISO datetime)')
+        .optional()
+        .describe('Fecha inicio del rango en formato ISO 8601 (YYYY-MM-DD). Inclusive.'),
+    fechaHasta: z
+        .string()
+        .regex(/^\d{4}-\d{2}-\d{2}(T\d{2}:\d{2}(:\d{2}(\.\d+)?)?(Z|[+-]\d{2}:\d{2})?)?$/, 'Debe ser una fecha ISO 8601 (YYYY-MM-DD o ISO datetime)')
+        .optional()
+        .describe('Fecha fin del rango en formato ISO 8601 (YYYY-MM-DD). Inclusive.'),
+});
+/**
+ * Filtros de identidad para entidades de Freemática.
+ *
+ * Permite filtrar por cliente, grupo de clientes, proveedor o grupo de
+ * proveedores. Todos los campos son opcionales y se combinan con AND cuando
+ * se usan junto con `BaseFiltersSchema`.
+ *
+ * Los códigos deben ser los códigos naturales del API de Freemática (ej.
+ * `COD_CLI`, `GRUPO_CLI`, `COD_PRO`, `GRUPO_PRO`).
+ */
+export const IdentityFiltersSchema = z.object({
+    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).'),
+    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 (GRUPO_PRO en Freemática).'),
+});
+/**
+ * Schema base para tools que necesitan paginación + rango de fechas + filtros
+ * de identidad.
+ *
+ * Combina `PaginationSchema` + `DateRangeSchema` + `IdentityFiltersSchema`
+ * para que las tools que necesiten filtros tengan un único punto de importación.
+ *
+ * @example
+ * // Usar en el registro de una tool:
+ * import { BaseFiltersSchema } from '../schemas/filters.js';
+ * server.tool('mi_tool', desc, BaseFiltersSchema, ...);
+ */
+export const BaseFiltersSchema = z.object({
+    ...PaginationSchema,
+    ...DateRangeSchema.shape,
+    ...IdentityFiltersSchema.shape,
+});
+//# sourceMappingURL=filters.js.map

package/dist/schemas/filters.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"filters.js","sourceRoot":"","sources":["../../src/schemas/filters.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAEnD;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC,MAAM,CAAC;IACtC,UAAU,EAAE,CAAC;SACV,MAAM,EAAE;SACR,KAAK,CACJ,yEAAyE,EACzE,yDAAyD,CAC1D;SACA,QAAQ,EAAE;SACV,QAAQ,CAAC,qEAAqE,CAAC;IAClF,UAAU,EAAE,CAAC;SACV,MAAM,EAAE;SACR,KAAK,CACJ,yEAAyE,EACzE,yDAAyD,CAC1D;SACA,QAAQ,EAAE;SACV,QAAQ,CAAC,kEAAkE,CAAC;CAChF,CAAC,CAAC;AAIH;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5C,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,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,2DAA2D,CAAC;CACzE,CAAC,CAAC;AAIH;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC;IACxC,GAAG,gBAAgB;IACnB,GAAG,eAAe,CAAC,KAAK;IACxB,GAAG,qBAAqB,CAAC,KAAK;CAC/B,CAAC,CAAC"}

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

@@ -0,0 +1,26 @@
+import { z } from 'zod';
+/**
+ * Enum de catálogos de datos maestros disponibles en el API de Freemática.
+ *
+ * Cada entrada en este array corresponde a un catálogo consultable vía
+ * `freematica_get_master_data`. El endpoint asociado está definido en
+ * `CATALOG_ENDPOINTS`.
+ *
+ * Para añadir un nuevo catálogo:
+ *   1. Añadir el nombre aquí (mantener orden: tipos, geográficos, organizativos, inventario, financiero)
+ *   2. Añadir el endpoint en `CATALOG_ENDPOINTS`
+ *   3. Añadir descripción en `CATALOG_DESCRIPTIONS` de `src/tools/master-data.ts`
+ *   4. Añadir fila en la tabla "Datos maestros disponibles" del README
+ *   5. Añadir test en `tests/schemas/master-data.test.ts` y `tests/tools/master-data.test.ts`
+ */
+export declare const MASTER_DATA_CATALOGS: readonly ["tipos-contrato", "tipo-instalacion", "clases-servicios", "tipos-casos", "subtipos-casos", "tipos-oportunidad-negocio", "tipos-impuestos", "naturalezas-abono", "incidencecode", "claves-facturacion", "paises", "nacionalidades", "provincias", "poblaciones", "empresas", "delegaciones", "lineas-negocio", "cargos-clientes", "calendarios", "series", "familias", "subfamilias", "lineas", "bancos"];
+export type MasterDataCatalog = typeof MASTER_DATA_CATALOGS[number];
+export declare const MasterDataCatalogSchema: z.ZodEnum<["tipos-contrato", "tipo-instalacion", "clases-servicios", "tipos-casos", "subtipos-casos", "tipos-oportunidad-negocio", "tipos-impuestos", "naturalezas-abono", "incidencecode", "claves-facturacion", "paises", "nacionalidades", "provincias", "poblaciones", "empresas", "delegaciones", "lineas-negocio", "cargos-clientes", "calendarios", "series", "familias", "subfamilias", "lineas", "bancos"]>;
+/**
+ * Mapeo catálogo → endpoint REST de Freemática.
+ *
+ * Solo se incluyen endpoints que funcionan sin parámetros requeridos adicionales.
+ * Catálogos que requieren parámetros obligatorios no documentados (ej: `tipos-marcajes`
+ * con `sTipoMarcaje`) quedan excluidos hasta descubrir los valores válidos.
+ */
+export declare const CATALOG_ENDPOINTS: Record<MasterDataCatalog, string>;

package/dist/schemas/master-data.js

@@ -0,0 +1,86 @@
+import { z } from 'zod';
+/**
+ * Enum de catálogos de datos maestros disponibles en el API de Freemática.
+ *
+ * Cada entrada en este array corresponde a un catálogo consultable vía
+ * `freematica_get_master_data`. El endpoint asociado está definido en
+ * `CATALOG_ENDPOINTS`.
+ *
+ * Para añadir un nuevo catálogo:
+ *   1. Añadir el nombre aquí (mantener orden: tipos, geográficos, organizativos, inventario, financiero)
+ *   2. Añadir el endpoint en `CATALOG_ENDPOINTS`
+ *   3. Añadir descripción en `CATALOG_DESCRIPTIONS` de `src/tools/master-data.ts`
+ *   4. Añadir fila en la tabla "Datos maestros disponibles" del README
+ *   5. Añadir test en `tests/schemas/master-data.test.ts` y `tests/tools/master-data.test.ts`
+ */
+export const MASTER_DATA_CATALOGS = [
+    // --- Tipos / clasificaciones ---
+    'tipos-contrato',
+    'tipo-instalacion',
+    'clases-servicios',
+    'tipos-casos',
+    'subtipos-casos',
+    'tipos-oportunidad-negocio',
+    'tipos-impuestos',
+    'naturalezas-abono',
+    'incidencecode',
+    'claves-facturacion',
+    // --- Geográficos ---
+    'paises',
+    'nacionalidades',
+    'provincias',
+    'poblaciones',
+    // --- Organizativos ---
+    'empresas',
+    'delegaciones',
+    'lineas-negocio',
+    'cargos-clientes',
+    'calendarios',
+    'series',
+    // --- Inventario ---
+    'familias',
+    'subfamilias',
+    'lineas',
+    // --- Financiero ---
+    'bancos',
+];
+export const MasterDataCatalogSchema = z.enum(MASTER_DATA_CATALOGS);
+/**
+ * Mapeo catálogo → endpoint REST de Freemática.
+ *
+ * Solo se incluyen endpoints que funcionan sin parámetros requeridos adicionales.
+ * Catálogos que requieren parámetros obligatorios no documentados (ej: `tipos-marcajes`
+ * con `sTipoMarcaje`) quedan excluidos hasta descubrir los valores válidos.
+ */
+export const CATALOG_ENDPOINTS = {
+    // Tipos / clasificaciones
+    'tipos-contrato': '/ppre/v2/tipos-contrato',
+    'tipo-instalacion': '/ppre/v1/tipo-instalacion',
+    'clases-servicios': '/pvss/v1/clases-servicios',
+    'tipos-casos': '/pcrm/v2/tipos-casos',
+    'subtipos-casos': '/pcrm/v2/subtipos-casos',
+    'tipos-oportunidad-negocio': '/pcrm/v2/tipos-oportunidad-negocio',
+    'tipos-impuestos': '/pgrl/v2/tipos-impuestos',
+    'naturalezas-abono': '/pven/v1/naturalezas-abono',
+    incidencecode: '/pvss/v2/incidencecode',
+    'claves-facturacion': '/pvss/v2/claves-facturacion',
+    // Geográficos
+    paises: '/pgrl/v1/paises',
+    nacionalidades: '/pgrl/v1/nacionalidades',
+    provincias: '/pgrl/v1/provincias',
+    poblaciones: '/pgrl/v2/poblaciones',
+    // Organizativos
+    empresas: '/pgrl/v1/empresas',
+    delegaciones: '/pgrl/v1/delegaciones/agrupcod',
+    'lineas-negocio': '/pgrl/v2/lineas-negocio',
+    'cargos-clientes': '/pgrl/v2/cargos-clientes',
+    calendarios: '/pgrl/v1/calendarios',
+    series: '/pgrl/v2/series',
+    // Inventario
+    familias: '/part/v1/familias',
+    subfamilias: '/part/v1/subfamilias',
+    lineas: '/part/v1/lineas',
+    // Financiero
+    bancos: '/pgrl/v2/bancos',
+};
+//# sourceMappingURL=master-data.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"master-data.js","sourceRoot":"","sources":["../../src/schemas/master-data.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,kCAAkC;IAClC,gBAAgB;IAChB,kBAAkB;IAClB,kBAAkB;IAClB,aAAa;IACb,gBAAgB;IAChB,2BAA2B;IAC3B,iBAAiB;IACjB,mBAAmB;IACnB,eAAe;IACf,oBAAoB;IACpB,sBAAsB;IACtB,QAAQ;IACR,gBAAgB;IAChB,YAAY;IACZ,aAAa;IACb,wBAAwB;IACxB,UAAU;IACV,cAAc;IACd,gBAAgB;IAChB,iBAAiB;IACjB,aAAa;IACb,QAAQ;IACR,qBAAqB;IACrB,UAAU;IACV,aAAa;IACb,QAAQ;IACR,qBAAqB;IACrB,QAAQ;CACA,CAAC;AAIX,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC;AAEpE;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAsC;IAClE,0BAA0B;IAC1B,gBAAgB,EAAE,yBAAyB;IAC3C,kBAAkB,EAAE,2BAA2B;IAC/C,kBAAkB,EAAE,2BAA2B;IAC/C,aAAa,EAAE,sBAAsB;IACrC,gBAAgB,EAAE,yBAAyB;IAC3C,2BAA2B,EAAE,oCAAoC;IACjE,iBAAiB,EAAE,0BAA0B;IAC7C,mBAAmB,EAAE,4BAA4B;IACjD,aAAa,EAAE,wBAAwB;IACvC,oBAAoB,EAAE,6BAA6B;IACnD,cAAc;IACd,MAAM,EAAE,iBAAiB;IACzB,cAAc,EAAE,yBAAyB;IACzC,UAAU,EAAE,qBAAqB;IACjC,WAAW,EAAE,sBAAsB;IACnC,gBAAgB;IAChB,QAAQ,EAAE,mBAAmB;IAC7B,YAAY,EAAE,gCAAgC;IAC9C,gBAAgB,EAAE,yBAAyB;IAC3C,iBAAiB,EAAE,0BAA0B;IAC7C,WAAW,EAAE,sBAAsB;IACnC,MAAM,EAAE,iBAAiB;IACzB,aAAa;IACb,QAAQ,EAAE,mBAAmB;IAC7B,WAAW,EAAE,sBAAsB;IACnC,MAAM,EAAE,iBAAiB;IACzB,aAAa;IACb,MAAM,EAAE,iBAAiB;CAC1B,CAAC"}

package/dist/schemas/pagination.d.ts

@@ -0,0 +1,14 @@
+import { z } from 'zod';
+/**
+ * Schema parts to paginate Freemática listing tools.
+ *
+ * IMPORTANT: We block `page=0` because the Freemática API treats it as
+ * "return the FULL dataset" (we measured 2.5 MB responses on the clientes
+ * endpoint). Pages are 1-indexed.
+ *
+ * `items` is capped at 50 to keep LLM context manageable.
+ */
+export declare const PaginationSchema: {
+    page: z.ZodDefault<z.ZodNumber>;
+    items: z.ZodDefault<z.ZodNumber>;
+};

package/dist/schemas/pagination.js

@@ -0,0 +1,27 @@
+import { z } from 'zod';
+/**
+ * Schema parts to paginate Freemática listing tools.
+ *
+ * IMPORTANT: We block `page=0` because the Freemática API treats it as
+ * "return the FULL dataset" (we measured 2.5 MB responses on the clientes
+ * endpoint). Pages are 1-indexed.
+ *
+ * `items` is capped at 50 to keep LLM context manageable.
+ */
+export const PaginationSchema = {
+    page: z
+        .number()
+        .int()
+        .min(1)
+        .max(999)
+        .default(1)
+        .describe('Página a recuperar (1-indexed). Default: 1. AVISO: el API trata page=0 como "devuelve TODO el dataset"; este parámetro lo bloquea al mínimo 1.'),
+    items: z
+        .number()
+        .int()
+        .min(1)
+        .max(50)
+        .default(20)
+        .describe('Items por página. Default 20, máximo 50.'),
+};
+//# sourceMappingURL=pagination.js.map

package/dist/schemas/pagination.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pagination.js","sourceRoot":"","sources":["../../src/schemas/pagination.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,IAAI,EAAE,CAAC;SACJ,MAAM,EAAE;SACR,GAAG,EAAE;SACL,GAAG,CAAC,CAAC,CAAC;SACN,GAAG,CAAC,GAAG,CAAC;SACR,OAAO,CAAC,CAAC,CAAC;SACV,QAAQ,CACP,gJAAgJ,CACjJ;IACH,KAAK,EAAE,CAAC;SACL,MAAM,EAAE;SACR,GAAG,EAAE;SACL,GAAG,CAAC,CAAC,CAAC;SACN,GAAG,CAAC,EAAE,CAAC;SACP,OAAO,CAAC,EAAE,CAAC;SACX,QAAQ,CAAC,0CAA0C,CAAC;CACxD,CAAC"}