feat: parámetros de solo lectura en los reportes (se ven con su valor por defecto y no se pueden cambiar; el servidor los ignora)

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>

apps/api/src/htmlreports/html-reports.service.ts

@@ -24,7 +24,8 @@ export function parseHtmlValues(def: HtmlReportDef, raw: Readonly<Record<string,
   const missing: string[] = [];
   for (const p of def.params) {
     const v = raw[p.name];
-    let text = typeof v === 'string' ? v.trim() : typeof v === 'number' ? String(v) : '';
+    // un parámetro de solo lectura vale siempre su valor por defecto, escriba lo que escriba el cliente
+    let text = p.readOnly ? '' : typeof v === 'string' ? v.trim() : typeof v === 'number' ? String(v) : '';
     if (text === '') text = p.defaultValue ?? '';
     if (text === '') {
       if (p.required) missing.push(p.label);

apps/api/src/htmlreports/html-reports.spec.ts

@@ -48,11 +48,18 @@ describe('registro de reportes HTML', () => {
     expect(() => validateHtmlReports([{ ...def, params: [P({ name: 'a' }), P({ name: 'a' })] }])).toThrow(/repite el parámetro/);
     expect(() => validateHtmlReports([{ ...def, template: '../fuera.njk' }])).toThrow(/dentro de la carpeta/);
     expect(() => validateHtmlReports([{ ...def, template: '/etc/passwd' }])).toThrow(/dentro de la carpeta/);
+    expect(() => validateHtmlReports([{ ...def, params: [P({ name: 'papel', readOnly: true })] }])).toThrow(/solo lectura y necesita un valor por defecto/);
     expect(validateHtmlReports([def])).toHaveLength(1);
   });
 });
 
 describe('valores de los parámetros', () => {
+  it('un parámetro de solo lectura vale siempre su valor por defecto, aunque el cliente mande otro', () => {
+    const fijo = { ...def, params: [P({ name: 'papel', label: 'Papel', kind: 'select', options: [{ value: 'Carta', label: 'Carta' }, { value: 'A4', label: 'A4' }], defaultValue: 'Carta', readOnly: true })] };
+    expect(parseHtmlValues(fijo, {})).toEqual({ papel: 'Carta' });
+    expect(parseHtmlValues(fijo, { papel: 'A4' })).toEqual({ papel: 'Carta' });
+  });
+
   it('exige los obligatorios, aplica el valor por defecto y comprueba tipos', () => {
     expect(parseHtmlValues(def, { doc: '144153', cantidad: 6 })).toEqual({ doc: '144153', cantidad: '6', papel: 'Carta', fecha: '' });
     expect(() => parseHtmlValues(def, { cantidad: '6' })).toThrow(/Falta indicar: Entrega/);

apps/api/src/htmlreports/html-reports.ts

@@ -16,6 +16,7 @@ export function validateHtmlReports(reports: readonly HtmlReportDef[]): readonly
     for (const p of r.params) {
       if (names.has(p.name)) throw new Error(`El reporte ${r.code} repite el parámetro ${p.name}`);
       names.add(p.name);
+      if (p.readOnly && !p.defaultValue) throw new Error(`El parámetro ${p.name} de ${r.code} es de solo lectura y necesita un valor por defecto`);
     }
   }
   return reports;