@nubiia/mcp-freematica 0.6.1

package/dist/config.d.ts

@@ -0,0 +1,104 @@
+import { z } from 'zod';
+declare const AuthConfigSchema: z.ZodObject<{
+    FREEMATICA_BASE_URL: z.ZodDefault<z.ZodString>;
+    FREEMATICA_AUTH_TOKEN: z.ZodString;
+    FREEMATICA_AUTH_COMPANY: z.ZodString;
+    FREEMATICA_AUTH_ORGANIZATION: z.ZodString;
+    FREEMATICA_AUTH_APP: z.ZodString;
+    FREEMATICA_AUTH_SESSION: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    FREEMATICA_BASE_URL: string;
+    FREEMATICA_AUTH_TOKEN: string;
+    FREEMATICA_AUTH_COMPANY: string;
+    FREEMATICA_AUTH_ORGANIZATION: string;
+    FREEMATICA_AUTH_APP: string;
+    FREEMATICA_AUTH_SESSION: string;
+}, {
+    FREEMATICA_AUTH_TOKEN: string;
+    FREEMATICA_AUTH_COMPANY: string;
+    FREEMATICA_AUTH_ORGANIZATION: string;
+    FREEMATICA_AUTH_APP: string;
+    FREEMATICA_AUTH_SESSION: string;
+    FREEMATICA_BASE_URL?: string | undefined;
+}>;
+declare const HttpConfigSchema: z.ZodObject<{
+    MCP_PORT: z.ZodDefault<z.ZodNumber>;
+    MCP_ALLOWED_ORIGINS: z.ZodDefault<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    MCP_PORT: number;
+    MCP_ALLOWED_ORIGINS: string;
+}, {
+    MCP_PORT?: number | undefined;
+    MCP_ALLOWED_ORIGINS?: string | undefined;
+}>;
+/**
+ * Configuración de hardening del cliente HTTP.
+ *
+ * Todas las variables tienen valores por defecto seguros que no requieren
+ * configuración explícita en la mayoría de los entornos.
+ */
+declare const HardeningConfigSchema: z.ZodObject<{
+    /**
+     * Timeout por petición HTTP en milisegundos.
+     * Por defecto: 30000 (30 segundos).
+     */
+    FREEMATICA_TIMEOUT_MS: z.ZodDefault<z.ZodNumber>;
+    /**
+     * Número máximo de reintentos para errores 5xx y errores de red.
+     * Los errores 4xx nunca se reintentan.
+     * Por defecto: 3.
+     */
+    FREEMATICA_MAX_RETRIES: z.ZodDefault<z.ZodNumber>;
+    /**
+     * Nivel de logging de pino.
+     * Valores válidos: trace | debug | info | warn | error | fatal.
+     * Por defecto: info.
+     */
+    LOG_LEVEL: z.ZodDefault<z.ZodEnum<["trace", "debug", "info", "warn", "error", "fatal"]>>;
+    /**
+     * Número de fallos consecutivos antes de abrir el circuit breaker.
+     * Por defecto: 5.
+     */
+    FREEMATICA_CIRCUIT_BREAKER_THRESHOLD: z.ZodDefault<z.ZodNumber>;
+    /**
+     * Tiempo en ms que el circuit breaker permanece abierto antes de pasar
+     * a half-open para intentar recuperarse.
+     * Por defecto: 30000 (30 segundos).
+     */
+    FREEMATICA_CIRCUIT_BREAKER_TIMEOUT_MS: z.ZodDefault<z.ZodNumber>;
+    /**
+     * Tamaño máximo de respuesta aceptado por freematica_export_asientos en
+     * megabytes. Si la respuesta del API supera este umbral, los datos se
+     * truncan y se añade un campo `warning` a la respuesta de la tool.
+     *
+     * Se recomienda usar rangos de fecha cortos (max. 1 mes) para evitar
+     * alcanzar este límite.
+     *
+     * Por defecto: 10 (10 MB).
+     * Mínimo: 1 MB. Máximo: 500 MB.
+     */
+    FREEMATICA_MAX_RESPONSE_SIZE_MB: z.ZodDefault<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    FREEMATICA_TIMEOUT_MS: number;
+    FREEMATICA_MAX_RETRIES: number;
+    LOG_LEVEL: "trace" | "debug" | "info" | "warn" | "error" | "fatal";
+    FREEMATICA_CIRCUIT_BREAKER_THRESHOLD: number;
+    FREEMATICA_CIRCUIT_BREAKER_TIMEOUT_MS: number;
+    FREEMATICA_MAX_RESPONSE_SIZE_MB: number;
+}, {
+    FREEMATICA_TIMEOUT_MS?: number | undefined;
+    FREEMATICA_MAX_RETRIES?: number | undefined;
+    LOG_LEVEL?: "trace" | "debug" | "info" | "warn" | "error" | "fatal" | undefined;
+    FREEMATICA_CIRCUIT_BREAKER_THRESHOLD?: number | undefined;
+    FREEMATICA_CIRCUIT_BREAKER_TIMEOUT_MS?: number | undefined;
+    FREEMATICA_MAX_RESPONSE_SIZE_MB?: number | undefined;
+}>;
+export type AuthConfig = z.infer<typeof AuthConfigSchema>;
+export type HttpConfig = z.infer<typeof HttpConfigSchema>;
+export type HardeningConfig = z.infer<typeof HardeningConfigSchema>;
+export type Config = AuthConfig & HttpConfig & HardeningConfig;
+export declare function loadAuthConfig(): AuthConfig;
+export declare function loadHttpConfig(): HttpConfig;
+export declare function loadHardeningConfig(): HardeningConfig;
+export declare function loadConfig(): Config;
+export {};

package/dist/config.js

@@ -0,0 +1,105 @@
+import { z } from 'zod';
+const AuthConfigSchema = z.object({
+    FREEMATICA_BASE_URL: z
+        .string()
+        .url()
+        .default('https://api-p01.clientservicepanel.com/restsat/api'),
+    FREEMATICA_AUTH_TOKEN: z.string().min(1),
+    FREEMATICA_AUTH_COMPANY: z.string().min(1),
+    FREEMATICA_AUTH_ORGANIZATION: z.string().min(1),
+    FREEMATICA_AUTH_APP: z.string().min(1),
+    FREEMATICA_AUTH_SESSION: z.string().min(1),
+});
+const HttpConfigSchema = z.object({
+    MCP_PORT: z.coerce.number().int().min(1).max(65535).default(3000),
+    MCP_ALLOWED_ORIGINS: z.string().default('*'),
+});
+/**
+ * Configuración de hardening del cliente HTTP.
+ *
+ * Todas las variables tienen valores por defecto seguros que no requieren
+ * configuración explícita en la mayoría de los entornos.
+ */
+const HardeningConfigSchema = z.object({
+    /**
+     * Timeout por petición HTTP en milisegundos.
+     * Por defecto: 30000 (30 segundos).
+     */
+    FREEMATICA_TIMEOUT_MS: z.coerce.number().int().min(1000).max(300_000).default(30_000),
+    /**
+     * Número máximo de reintentos para errores 5xx y errores de red.
+     * Los errores 4xx nunca se reintentan.
+     * Por defecto: 3.
+     */
+    FREEMATICA_MAX_RETRIES: z.coerce.number().int().min(0).max(10).default(3),
+    /**
+     * Nivel de logging de pino.
+     * Valores válidos: trace | debug | info | warn | error | fatal.
+     * Por defecto: info.
+     */
+    LOG_LEVEL: z
+        .enum(['trace', 'debug', 'info', 'warn', 'error', 'fatal'])
+        .default('info'),
+    /**
+     * Número de fallos consecutivos antes de abrir el circuit breaker.
+     * Por defecto: 5.
+     */
+    FREEMATICA_CIRCUIT_BREAKER_THRESHOLD: z.coerce.number().int().min(1).max(100).default(5),
+    /**
+     * Tiempo en ms que el circuit breaker permanece abierto antes de pasar
+     * a half-open para intentar recuperarse.
+     * Por defecto: 30000 (30 segundos).
+     */
+    FREEMATICA_CIRCUIT_BREAKER_TIMEOUT_MS: z.coerce
+        .number()
+        .int()
+        .min(1000)
+        .max(3_600_000)
+        .default(30_000),
+    /**
+     * Tamaño máximo de respuesta aceptado por freematica_export_asientos en
+     * megabytes. Si la respuesta del API supera este umbral, los datos se
+     * truncan y se añade un campo `warning` a la respuesta de la tool.
+     *
+     * Se recomienda usar rangos de fecha cortos (max. 1 mes) para evitar
+     * alcanzar este límite.
+     *
+     * Por defecto: 10 (10 MB).
+     * Mínimo: 1 MB. Máximo: 500 MB.
+     */
+    FREEMATICA_MAX_RESPONSE_SIZE_MB: z.coerce
+        .number()
+        .int()
+        .min(1)
+        .max(500)
+        .default(10),
+});
+function formatZodError(err) {
+    const issues = err.issues
+        .map((i) => `  - ${i.path.join('.')}: ${i.message}`)
+        .join('\n');
+    return (`[freematica-mcp] Invalid configuration:\n${issues}\n\n` +
+        `Set the missing/invalid environment variables and restart.`);
+}
+export function loadAuthConfig() {
+    const result = AuthConfigSchema.safeParse(process.env);
+    if (!result.success)
+        throw new Error(formatZodError(result.error));
+    return result.data;
+}
+export function loadHttpConfig() {
+    const result = HttpConfigSchema.safeParse(process.env);
+    if (!result.success)
+        throw new Error(formatZodError(result.error));
+    return result.data;
+}
+export function loadHardeningConfig() {
+    const result = HardeningConfigSchema.safeParse(process.env);
+    if (!result.success)
+        throw new Error(formatZodError(result.error));
+    return result.data;
+}
+export function loadConfig() {
+    return { ...loadAuthConfig(), ...loadHttpConfig(), ...loadHardeningConfig() };
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/index.js

@@ -0,0 +1,55 @@
+#!/usr/bin/env node
+import { loadAuthConfig } from './config.js';
+import { FreematicaClient } from './clients/freematica-client.js';
+function parseArg(name) {
+    const prefix = `--${name}=`;
+    const arg = process.argv.find((a) => a.startsWith(prefix));
+    return arg ? arg.slice(prefix.length) : undefined;
+}
+const TRANSPORT = parseArg('transport') ?? process.env.MCP_TRANSPORT ?? 'stdio';
+async function main() {
+    const auth = loadAuthConfig();
+    const client = new FreematicaClient({
+        baseUrl: auth.FREEMATICA_BASE_URL,
+        authHeaders: {
+            'x-auth-token': auth.FREEMATICA_AUTH_TOKEN,
+            'x-auth-company': auth.FREEMATICA_AUTH_COMPANY,
+            'x-auth-organization': auth.FREEMATICA_AUTH_ORGANIZATION,
+            'x-auth-app': auth.FREEMATICA_AUTH_APP,
+            'x-auth-session': auth.FREEMATICA_AUTH_SESSION,
+        },
+    });
+    if (TRANSPORT === 'http') {
+        const { loadHttpConfig } = await import('./config.js');
+        const { createHttpApp } = await import('./transports/http.js');
+        const http = loadHttpConfig();
+        const { app, shutdown } = await createHttpApp({
+            port: http.MCP_PORT,
+            client,
+            allowedOrigins: http.MCP_ALLOWED_ORIGINS,
+        });
+        process.on('SIGTERM', () => {
+            void shutdown().then(() => process.exit(0));
+        });
+        process.on('SIGINT', () => {
+            void shutdown().then(() => process.exit(0));
+        });
+        app.listen(http.MCP_PORT, () => {
+            console.error(`[freematica-mcp] HTTP transport listening on port ${http.MCP_PORT} | base=${auth.FREEMATICA_BASE_URL}`);
+            console.error(`[freematica-mcp] MCP endpoint:    http://localhost:${http.MCP_PORT}/mcp`);
+            console.error(`[freematica-mcp] Health endpoint: http://localhost:${http.MCP_PORT}/health`);
+        });
+        return;
+    }
+    if (TRANSPORT !== 'stdio') {
+        console.error(`[freematica-mcp] Unknown transport "${TRANSPORT}". Valid: stdio, http. Defaulting to stdio.`);
+    }
+    console.error(`[freematica-mcp] Starting stdio transport v0.6.0 | base=${auth.FREEMATICA_BASE_URL}`);
+    const { startStdio } = await import('./transports/stdio.js');
+    await startStdio({ client });
+}
+main().catch((err) => {
+    console.error('[freematica-mcp] FATAL:', err instanceof Error ? err.message : err);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/logger.d.ts

@@ -0,0 +1,71 @@
+import pino from 'pino';
+/**
+ * Nombres de los headers de autenticación de Freemática que NUNCA deben
+ * aparecer en ningún log, en ningún nivel (incluido debug y trace).
+ *
+ * Se usa tanto para sanitizar headers antes de loguear como para verificar
+ * que el logger no filtra datos sensibles.
+ */
+export declare const AUTH_HEADER_NAMES: readonly ["x-auth-token", "x-auth-company", "x-auth-organization", "x-auth-app", "x-auth-session"];
+export type AuthHeaderName = (typeof AUTH_HEADER_NAMES)[number];
+/**
+ * Niveles de log configurables vía la variable de entorno `LOG_LEVEL`.
+ *
+ * El nivel por defecto es `info`.
+ *
+ * @see https://getpino.io/#/docs/api?id=level-string
+ */
+export type LogLevel = 'trace' | 'debug' | 'info' | 'warn' | 'error' | 'fatal';
+/**
+ * Sanitiza un objeto de headers eliminando todas las claves de autenticación.
+ *
+ * Retorna un nuevo objeto sin modificar el original. Las claves se comparan
+ * en lowercase para cubrir variaciones de capitalización.
+ *
+ * @param headers - Headers HTTP a sanitizar.
+ * @returns Copia de `headers` sin los headers x-auth-*.
+ */
+export declare function sanitizeHeaders(headers: Record<string, unknown>): Record<string, unknown>;
+/**
+ * Crea una instancia del logger pino con la configuración estándar.
+ *
+ * La función acepta opcionalmente un stream destino para permitir testing:
+ * en tests se puede pasar un stream writable en memoria para verificar que
+ * los headers sensibles NUNCA aparecen en el output.
+ *
+ * Configurado con:
+ * - Nivel configurable vía `LOG_LEVEL` (default: `info`)
+ * - Serializer `req` que sanitiza headers x-auth-* automáticamente
+ *
+ * @param destination - Stream destino opcional (por defecto: `pino.destination(1)` = stdout).
+ * @returns Instancia del logger pino.
+ *
+ * @example
+ * // Logger de producción (singleton)
+ * import { logger } from './logger.js';
+ *
+ * @example
+ * // Logger de test con stream en memoria
+ * import { createLogger } from './logger.js';
+ * import { Writable } from 'node:stream';
+ * const chunks: string[] = [];
+ * const dest = new Writable({ write(chunk, _, cb) { chunks.push(chunk.toString()); cb(); } });
+ * const testLogger = createLogger(dest);
+ * testLogger.info({ headers: { 'x-auth-token': 'SECRET' } }, 'req');
+ * // Verificar que 'SECRET' no aparece en chunks
+ */
+export declare function createLogger(destination?: pino.DestinationStream): pino.Logger;
+/**
+ * Logger singleton de la aplicación.
+ *
+ * Configurado con:
+ * - Nivel configurable vía `LOG_LEVEL` (default: `info`)
+ * - Serializer `req` que sanitiza headers x-auth-* automáticamente
+ *
+ * Uso:
+ * ```ts
+ * import { logger } from './logger.js';
+ * logger.info({ requestId: 'uuid', method: 'GET', path: '/clientes' }, 'HTTP request');
+ * ```
+ */
+export declare const logger: pino.Logger<never, boolean>;

package/dist/logger.js

@@ -0,0 +1,114 @@
+import pino from 'pino';
+/**
+ * Nombres de los headers de autenticación de Freemática que NUNCA deben
+ * aparecer en ningún log, en ningún nivel (incluido debug y trace).
+ *
+ * Se usa tanto para sanitizar headers antes de loguear como para verificar
+ * que el logger no filtra datos sensibles.
+ */
+export const AUTH_HEADER_NAMES = [
+    'x-auth-token',
+    'x-auth-company',
+    'x-auth-organization',
+    'x-auth-app',
+    'x-auth-session',
+];
+const VALID_LEVELS = ['trace', 'debug', 'info', 'warn', 'error', 'fatal'];
+function resolveLogLevel() {
+    const raw = (process.env['LOG_LEVEL'] ?? 'info').toLowerCase();
+    if (VALID_LEVELS.includes(raw))
+        return raw;
+    // Nivel inválido → fallback a info (no lanzar porque puede romper startup)
+    process.stderr.write(`[freematica-mcp] WARNING: LOG_LEVEL="${raw}" no es válido. Usando "info".\n`);
+    return 'info';
+}
+/**
+ * Sanitiza un objeto de headers eliminando todas las claves de autenticación.
+ *
+ * Retorna un nuevo objeto sin modificar el original. Las claves se comparan
+ * en lowercase para cubrir variaciones de capitalización.
+ *
+ * @param headers - Headers HTTP a sanitizar.
+ * @returns Copia de `headers` sin los headers x-auth-*.
+ */
+export function sanitizeHeaders(headers) {
+    const sanitized = {};
+    for (const [key, value] of Object.entries(headers)) {
+        if (!AUTH_HEADER_NAMES.includes(key.toLowerCase())) {
+            sanitized[key] = value;
+        }
+    }
+    return sanitized;
+}
+/**
+ * Serializer de pino para objetos `req` (peticiones HTTP salientes).
+ *
+ * Elimina headers de autenticación del objeto antes de serializar. Nunca
+ * incluye el body de la petición para evitar filtrar credenciales o PII.
+ *
+ * @param req - Objeto de petición con headers y metadatos.
+ * @returns Representación sanitizada para el log.
+ */
+function reqSerializer(req) {
+    if (typeof req !== 'object' || req === null)
+        return req;
+    const r = req;
+    return {
+        method: r.method,
+        path: r.path,
+        // Sanitizar headers: nunca x-auth-*
+        headers: r.headers ? sanitizeHeaders(r.headers) : undefined,
+    };
+}
+/**
+ * Crea una instancia del logger pino con la configuración estándar.
+ *
+ * La función acepta opcionalmente un stream destino para permitir testing:
+ * en tests se puede pasar un stream writable en memoria para verificar que
+ * los headers sensibles NUNCA aparecen en el output.
+ *
+ * Configurado con:
+ * - Nivel configurable vía `LOG_LEVEL` (default: `info`)
+ * - Serializer `req` que sanitiza headers x-auth-* automáticamente
+ *
+ * @param destination - Stream destino opcional (por defecto: `pino.destination(1)` = stdout).
+ * @returns Instancia del logger pino.
+ *
+ * @example
+ * // Logger de producción (singleton)
+ * import { logger } from './logger.js';
+ *
+ * @example
+ * // Logger de test con stream en memoria
+ * import { createLogger } from './logger.js';
+ * import { Writable } from 'node:stream';
+ * const chunks: string[] = [];
+ * const dest = new Writable({ write(chunk, _, cb) { chunks.push(chunk.toString()); cb(); } });
+ * const testLogger = createLogger(dest);
+ * testLogger.info({ headers: { 'x-auth-token': 'SECRET' } }, 'req');
+ * // Verificar que 'SECRET' no aparece en chunks
+ */
+export function createLogger(destination) {
+    return pino({
+        level: resolveLogLevel(),
+        serializers: {
+            req: reqSerializer,
+            err: pino.stdSerializers.err,
+        },
+    }, destination);
+}
+/**
+ * Logger singleton de la aplicación.
+ *
+ * Configurado con:
+ * - Nivel configurable vía `LOG_LEVEL` (default: `info`)
+ * - Serializer `req` que sanitiza headers x-auth-* automáticamente
+ *
+ * Uso:
+ * ```ts
+ * import { logger } from './logger.js';
+ * logger.info({ requestId: 'uuid', method: 'GET', path: '/clientes' }, 'HTTP request');
+ * ```
+ */
+export const logger = createLogger();
+//# sourceMappingURL=logger.js.map

package/dist/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,MAAM,CAAC;AAExB;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,cAAc;IACd,gBAAgB;IAChB,qBAAqB;IACrB,YAAY;IACZ,gBAAgB;CACR,CAAC;AAaX,MAAM,YAAY,GAAe,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;AAEtF,SAAS,eAAe;IACtB,MAAM,GAAG,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,IAAI,MAAM,CAAC,CAAC,WAAW,EAAE,CAAC;IAC/D,IAAI,YAAY,CAAC,QAAQ,CAAC,GAAe,CAAC;QAAE,OAAO,GAAe,CAAC;IACnE,2EAA2E;IAC3E,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,wCAAwC,GAAG,kCAAkC,CAC9E,CAAC;IACF,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,eAAe,CAAC,OAAgC;IAC9D,MAAM,SAAS,GAA4B,EAAE,CAAC;IAC9C,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;QACnD,IAAI,CAAC,iBAAiB,CAAC,QAAQ,CAAC,GAAG,CAAC,WAAW,EAAoB,CAAC,EAAE,CAAC;YACrE,SAAS,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;QACzB,CAAC;IACH,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;;;;;;;GAQG;AACH,SAAS,aAAa,CACpB,GAAoF;IAEpF,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,IAAI;QAAE,OAAO,GAAG,CAAC;IACxD,MAAM,CAAC,GAAG,GAA4E,CAAC;IACvF,OAAO;QACL,MAAM,EAAE,CAAC,CAAC,MAAM;QAChB,IAAI,EAAE,CAAC,CAAC,IAAI;QACZ,oCAAoC;QACpC,OAAO,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,SAAS;KAC5D,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,MAAM,UAAU,YAAY,CAAC,WAAoC;IAC/D,OAAO,IAAI,CACT;QACE,KAAK,EAAE,eAAe,EAAE;QACxB,WAAW,EAAE;YACX,GAAG,EAAE,aAAa;YAClB,GAAG,EAAE,IAAI,CAAC,cAAc,CAAC,GAAG;SAC7B;KACF,EACD,WAAW,CACZ,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,MAAM,MAAM,GAAG,YAAY,EAAE,CAAC"}

package/dist/schemas/albaranes.d.ts

@@ -0,0 +1,124 @@
+import { z } from 'zod';
+/**
+ * Filtros tipados para `freematica_list_albaranes_ventas`.
+ *
+ * El endpoint GET /pven/v2/albaranes-ventas usa exclusivamente query params
+ * nativos. `codEmpresa` es obligatorio según el spec OpenAPI.
+ *
+ * Mapeo:
+ * | Filtro       | Query param    |
+ * |--------------|----------------|
+ * | empresa      | codEmpresa     |
+ * | delegacion   | codDelegacion  |
+ * | codCliente   | codCliente     |
+ * | codDocumento | codDocumento   |
+ * | fechaDesde   | desdeFecha     |
+ * | fechaHasta   | hastaFecha     |
+ * | order        | order          |
+ */
+export declare const ListAlbaranesVentasFiltersSchema: {
+    empresa: z.ZodString;
+    delegacion: z.ZodOptional<z.ZodString>;
+    codCliente: z.ZodOptional<z.ZodString>;
+    codDocumento: z.ZodOptional<z.ZodString>;
+    fechaDesde: z.ZodOptional<z.ZodString>;
+    fechaHasta: z.ZodOptional<z.ZodString>;
+    order: z.ZodOptional<z.ZodString>;
+    page: z.ZodDefault<z.ZodNumber>;
+    items: z.ZodDefault<z.ZodNumber>;
+};
+export type ListAlbaranesVentasFilters = {
+    page?: number;
+    items?: number;
+    empresa: string;
+    delegacion?: string;
+    codCliente?: string;
+    codDocumento?: string;
+    fechaDesde?: string;
+    fechaHasta?: string;
+    order?: string;
+};
+/**
+ * Filtros tipados para `freematica_list_albaranes_factura`.
+ *
+ * Endpoint: GET /pven/v2/albaranes-facturas
+ *
+ * El filtro `idReg` es un query param nativo. El resto se pasan como FIQL
+ * en el parámetro `rQuery`.
+ *
+ * Mapeo:
+ * | Filtro      | Mecanismo | Campo         |
+ * |-------------|-----------|---------------|
+ * | idReg       | nativo    | —             |
+ * | empresa     | FIQL      | FVCA_CODEMP   |
+ * | serie       | FIQL      | FVCA_SERIEFRA |
+ * | numFactura  | FIQL      | FVCA_NUMFRA   |
+ * | codCliente  | FIQL      | FVCA_CODCLI   |
+ */
+export declare const ListAlbaranesFacturaFiltersSchema: {
+    idReg: z.ZodOptional<z.ZodString>;
+    empresa: z.ZodOptional<z.ZodString>;
+    serie: z.ZodOptional<z.ZodString>;
+    numFactura: z.ZodOptional<z.ZodString>;
+    codCliente: z.ZodOptional<z.ZodString>;
+    page: z.ZodDefault<z.ZodNumber>;
+    items: z.ZodDefault<z.ZodNumber>;
+};
+export type ListAlbaranesFacturaFilters = {
+    page?: number;
+    items?: number;
+    idReg?: string;
+    empresa?: string;
+    serie?: string;
+    numFactura?: string;
+    codCliente?: string;
+};
+/**
+ * Filtros tipados para `freematica_list_resultados_facturacion`.
+ *
+ * Endpoint: GET /pvss/v1/facturacion-resultados
+ *
+ * Todos los filtros se envían como FIQL en el parámetro `rquery`.
+ *
+ * Mapeo:
+ * | Filtro      | Campo FIQL   |
+ * |-------------|--------------|
+ * | empresa     | FACT_EMP     |
+ * | delegacion  | FACT_DELEG   |
+ * | codCliente  | FACT_COD_CLI |
+ * | calendario  | FACT_CAL     |
+ * | mes         | FACT_MES     |
+ * | contrato    | FACT_CTRT    |
+ * | servicio    | FACT_SERV    |
+ * | tipoFac     | FACT_TIPFAC  |
+ * | traspasado  | FACT_TRASP   |
+ * | order       | order        |
+ */
+export declare const ListResultadosFacturacionFiltersSchema: {
+    empresa: z.ZodOptional<z.ZodString>;
+    delegacion: z.ZodOptional<z.ZodString>;
+    codCliente: z.ZodOptional<z.ZodString>;
+    calendario: z.ZodOptional<z.ZodString>;
+    mes: z.ZodOptional<z.ZodNumber>;
+    contrato: z.ZodOptional<z.ZodString>;
+    servicio: z.ZodOptional<z.ZodString>;
+    tipoFac: z.ZodOptional<z.ZodString>;
+    traspasado: z.ZodOptional<z.ZodString>;
+    order: z.ZodOptional<z.ZodString>;
+    page: z.ZodDefault<z.ZodNumber>;
+    items: z.ZodDefault<z.ZodNumber>;
+};
+export type ListResultadosFacturacionFilters = {
+    page?: number;
+    items?: number;
+    empresa?: string;
+    delegacion?: string;
+    codCliente?: string;
+    calendario?: string;
+    mes?: number;
+    contrato?: string;
+    servicio?: string;
+    tipoFac?: string;
+    traspasado?: string;
+    order?: string;
+};