@jvsoft/components 1.0.0-alpha.15 → 1.0.0-alpha.16

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (92) hide show
  1. package/fesm2022/jvsoft-components-alerta.mjs +19 -20
  2. package/fesm2022/jvsoft-components-alerta.mjs.map +1 -1
  3. package/fesm2022/jvsoft-components-dialog-flotante.mjs +15 -15
  4. package/fesm2022/jvsoft-components-dialog-flotante.mjs.map +1 -1
  5. package/fesm2022/jvsoft-components-filtro-busqueda.mjs +19 -19
  6. package/fesm2022/jvsoft-components-filtro-busqueda.mjs.map +1 -1
  7. package/fesm2022/jvsoft-components-foto-persona.mjs +481 -0
  8. package/fesm2022/jvsoft-components-foto-persona.mjs.map +1 -0
  9. package/fesm2022/jvsoft-components-lista-arbol.mjs +32 -34
  10. package/fesm2022/jvsoft-components-lista-arbol.mjs.map +1 -1
  11. package/fesm2022/jvsoft-components-luces-navidad.mjs +4 -8
  12. package/fesm2022/jvsoft-components-luces-navidad.mjs.map +1 -1
  13. package/fesm2022/jvsoft-components-mat-suffix-search-button.mjs +3 -3
  14. package/fesm2022/jvsoft-components-mat-suffix-search-button.mjs.map +1 -1
  15. package/fesm2022/jvsoft-components-menu.mjs +9 -12
  16. package/fesm2022/jvsoft-components-menu.mjs.map +1 -1
  17. package/fesm2022/jvsoft-components-tabla-mantenimiento-components-progress-bar.mjs +4 -4
  18. package/fesm2022/jvsoft-components-tabla-mantenimiento-components-progress-bar.mjs.map +1 -1
  19. package/fesm2022/jvsoft-components-tabla-mantenimiento.mjs +76 -78
  20. package/fesm2022/jvsoft-components-tabla-mantenimiento.mjs.map +1 -1
  21. package/fesm2022/jvsoft-components.mjs +9 -3015
  22. package/fesm2022/jvsoft-components.mjs.map +1 -1
  23. package/foto-persona/README.md +341 -0
  24. package/package.json +22 -17
  25. package/src/styles/base-jvsoft-components.css +1542 -5
  26. package/types/jvsoft-components-alerta.d.ts +33 -0
  27. package/types/jvsoft-components-dialog-flotante.d.ts +34 -0
  28. package/types/jvsoft-components-filtro-busqueda.d.ts +217 -0
  29. package/types/jvsoft-components-foto-persona.d.ts +300 -0
  30. package/types/jvsoft-components-lista-arbol.d.ts +60 -0
  31. package/{luces-navidad/luces-navidad.component.d.ts → types/jvsoft-components-luces-navidad.d.ts} +5 -2
  32. package/{mat-suffix-search-button/mat-suffix-search-button.component.d.ts → types/jvsoft-components-mat-suffix-search-button.d.ts} +5 -2
  33. package/{menu/menu.component.d.ts → types/jvsoft-components-menu.d.ts} +24 -4
  34. package/{tabla-mantenimiento/components/progress-bar/progress-bar.component.d.ts → types/jvsoft-components-tabla-mantenimiento-components-progress-bar.d.ts} +7 -3
  35. package/types/jvsoft-components-tabla-mantenimiento.d.ts +469 -0
  36. package/types/jvsoft-components.d.ts +9 -0
  37. package/alerta/alerta.component.d.ts +0 -29
  38. package/alerta/index.d.ts +0 -5
  39. package/alerta/public-api.d.ts +0 -1
  40. package/dialog-flotante/dialog-flotante.component.d.ts +0 -23
  41. package/dialog-flotante/dialog-flotante.interface.d.ts +0 -11
  42. package/dialog-flotante/index.d.ts +0 -5
  43. package/dialog-flotante/public-api.d.ts +0 -1
  44. package/filtro-busqueda/filtro-busqueda.component.d.ts +0 -89
  45. package/filtro-busqueda/filtro-busqueda.service.d.ts +0 -40
  46. package/filtro-busqueda/index.d.ts +0 -5
  47. package/filtro-busqueda/interfaces/filtro-busqueda.interface.d.ts +0 -86
  48. package/filtro-busqueda/public-api.d.ts +0 -3
  49. package/index.d.ts +0 -9
  50. package/lista-arbol/index.d.ts +0 -5
  51. package/lista-arbol/lista-arbol.component.d.ts +0 -57
  52. package/lista-arbol/lista-arbol.functions.d.ts +0 -8
  53. package/lista-arbol/public-api.d.ts +0 -1
  54. package/luces-navidad/index.d.ts +0 -5
  55. package/luces-navidad/public-api.d.ts +0 -1
  56. package/mat-suffix-search-button/index.d.ts +0 -5
  57. package/mat-suffix-search-button/public-api.d.ts +0 -1
  58. package/menu/index.d.ts +0 -5
  59. package/menu/menu.interface.d.ts +0 -16
  60. package/menu/public-api.d.ts +0 -2
  61. package/tabla-mantenimiento/classes/data-model.d.ts +0 -25
  62. package/tabla-mantenimiento/components/progress-bar/index.d.ts +0 -5
  63. package/tabla-mantenimiento/components/progress-bar/public-api.d.ts +0 -1
  64. package/tabla-mantenimiento/index.d.ts +0 -5
  65. package/tabla-mantenimiento/interfaces/Implements/incluye-tabla-mantenimiento.d.ts +0 -12
  66. package/tabla-mantenimiento/interfaces/Implements/index.d.ts +0 -1
  67. package/tabla-mantenimiento/interfaces/archivo.d.ts +0 -26
  68. package/tabla-mantenimiento/interfaces/global/boton-mantenimiento.d.ts +0 -41
  69. package/tabla-mantenimiento/interfaces/global/columnas-tabla.d.ts +0 -142
  70. package/tabla-mantenimiento/interfaces/global/index.d.ts +0 -3
  71. package/tabla-mantenimiento/interfaces/global/no-export.d.ts +0 -2
  72. package/tabla-mantenimiento/interfaces/global/otros.d.ts +0 -28
  73. package/tabla-mantenimiento/interfaces/index.d.ts +0 -3
  74. package/tabla-mantenimiento/mat-row-keyboard-selection.directive.d.ts +0 -19
  75. package/tabla-mantenimiento/pipes/no-sanitize.pipe.d.ts +0 -10
  76. package/tabla-mantenimiento/pipes/zero-fill.pipe.d.ts +0 -8
  77. package/tabla-mantenimiento/public-api.d.ts +0 -4
  78. package/tabla-mantenimiento/tabla-mantenimiento-column-defs/column-type/column-type-date/column-type-date.component.d.ts +0 -8
  79. package/tabla-mantenimiento/tabla-mantenimiento-column-defs/column-type/column-type-icons/column-type-icons.component.d.ts +0 -9
  80. package/tabla-mantenimiento/tabla-mantenimiento-column-defs/column-type/column-type-money/column-type-money.component.d.ts +0 -9
  81. package/tabla-mantenimiento/tabla-mantenimiento-column-defs/column-type/column-type-number/column-type-number.component.d.ts +0 -8
  82. package/tabla-mantenimiento/tabla-mantenimiento-column-defs/column-type/column-type-progressbar/column-type-progressbar.component.d.ts +0 -8
  83. package/tabla-mantenimiento/tabla-mantenimiento-column-defs/column-type/column-type-sino/column-type-sino.component.d.ts +0 -9
  84. package/tabla-mantenimiento/tabla-mantenimiento-column-defs/column-type/column-type-text/column-type-text.component.d.ts +0 -8
  85. package/tabla-mantenimiento/tabla-mantenimiento-column-defs/column-type/column-type.component.d.ts +0 -18
  86. package/tabla-mantenimiento/tabla-mantenimiento-column-defs/column-type/column-type.module.d.ts +0 -24
  87. package/tabla-mantenimiento/tabla-mantenimiento-column-defs/tabla-mantenimiento-column-defs.component.d.ts +0 -21
  88. package/tabla-mantenimiento/tabla-mantenimiento-menu/tabla-mantenimiento-menu.component.d.ts +0 -18
  89. package/tabla-mantenimiento/tabla-mantenimiento.component.d.ts +0 -159
  90. package/tabla-mantenimiento/tabla-mantenimiento.functions.d.ts +0 -5
  91. package/tabla-mantenimiento/tabla-mantenimiento.service.d.ts +0 -8
  92. package/tabla-mantenimiento/table-util.d.ts +0 -11
@@ -0,0 +1,481 @@
1
+ import * as i0 from '@angular/core';
2
+ import { InjectionToken, inject, signal, computed, Injectable, makeEnvironmentProviders, input, Component } from '@angular/core';
3
+ import { HttpClient } from '@angular/common/http';
4
+
5
+ const FOTO_PERSONA_CONFIG = new InjectionToken('FOTO_PERSONA_CONFIG');
6
+ const VACIO = { url: null, default: null, cargando: false };
7
+ /**
8
+ * Extensión que el backend emite para cada preset en `GET /api/imagenes/default/…`: los tres
9
+ * presets cuadrados chicos son WebP; `full` y `medium` hoy devuelven el original JPEG. Debe
10
+ * seguir a `FotografiaPersonaController::extensionEsperada()` del backend si eso cambia.
11
+ */
12
+ const EXTENSION_POR_PRESET = {
13
+ thumbnail: 'webp',
14
+ avatar: 'webp',
15
+ 'avatar-grande': 'webp',
16
+ full: 'jpg',
17
+ medium: 'jpg',
18
+ };
19
+ /**
20
+ * Nombre de archivo real de cada estático de falta, tal como vive hoy en
21
+ * `backend/public/img/falta/`. Existe SOLO por esto: las extensiones están mezcladas —
22
+ * `natural-m`, `natural-f`, `entidad`, `extranjero-m` y `extranjero-f` son `.png`, pero `falta`
23
+ * (el último recurso) es `.jpg`. Un consumidor que arme `${nombre}.png` a ciegas funciona para
24
+ * cinco de los seis y se rompe justo en el que nunca puede fallar. Este mapa es la única fuente
25
+ * de verdad de esos nombres de archivo para assets locales: que nadie vuelva a reconstruirlos.
26
+ * (No confundir con `EXTENSION_POR_PRESET`: ese deriva la extensión que sirve el *backend* según
27
+ * el *preset* pedido; este es el archivo fijo, sin variantes por preset, que empaqueta la app.)
28
+ */
29
+ const ARCHIVO_POR_DEFECTO = {
30
+ 'natural-m': 'natural-m.png',
31
+ 'natural-f': 'natural-f.png',
32
+ entidad: 'entidad.png',
33
+ 'extranjero-m': 'extranjero-m.png',
34
+ 'extranjero-f': 'extranjero-f.png',
35
+ falta: 'falta.jpg',
36
+ };
37
+ /**
38
+ * Acumula las peticiones de foto de persona que llegan en el mismo ciclo de
39
+ * detección de cambios y las resuelve con **un** `POST /api/imagenes/persona/lote`
40
+ * (o varios si el lote excede `loteMax`), en vez de una petición HTTP por
41
+ * componente. Ver diseño en `docs/superpowers/specs/2026-09-06-fotos-s3-central-design.md` § 8.3.
42
+ *
43
+ * ## Contrato de reintentos
44
+ * Hay una diferencia entre «el servidor contestó que no hay foto» (una respuesta real, se
45
+ * cachea para siempre) y «no pudimos ni preguntar» (una falla de red, que no es una respuesta y
46
+ * no debe tratarse como una). Por eso:
47
+ * - Una respuesta del servidor (con foto, o sin foto pero con `default`) queda **confirmada**:
48
+ * nunca se vuelve a pedir.
49
+ * - Una falla de red deja el resultado inmediato en «sin foto» (no se cuelga en `cargando`, no
50
+ * lanza), pero **no** queda confirmada. La clave entra en un cooldown corto (`cooldownMs`, 5 s
51
+ * por defecto) durante el cual ni `urlFoto()` ni el paso del tiempo la reintentan solos.
52
+ * - Pasado el cooldown, la clave queda **elegible**, no se reintenta sola: hace falta que algo
53
+ * la vuelva a pedir — típicamente un `urlFoto()` nuevo (un componente que se crea) o una
54
+ * llamada a `precargar()`. El cooldown expirando **no despierta a nadie** por sí mismo (no
55
+ * toca `tick`, ver `programarCooldown()`): si lo hiciera, cada falla programaría su propio
56
+ * cooldown, que al vencer despertaría a los mismos consumidores fallidos, que volverían a
57
+ * pedir, fallarían de nuevo y programarían otro cooldown — un poll perpetuo contra un backend
58
+ * caído. Una lectura de verdad nueva (navegación, tabla que se recarga con componentes nuevos,
59
+ * `precargar()`) es lo único que reintenta.
60
+ * - `precargar()` reintenta claves no confirmadas de inmediato, sin esperar el cooldown — para
61
+ * un botón "reintentar" o para precargar una tabla a propósito.
62
+ *
63
+ * ## Caducidad
64
+ * Las URL de foto real van firmadas por el backend y vencen (12 h como máximo), así que
65
+ * "confirmada" no significa "para siempre": una entrada con foto real vive `ttlUrlMs` —o lo
66
+ * que anuncie la cabecera `X-Fotos-Ttl`, que manda— y después se vuelve a pedir. Una persona
67
+ * sin foto no caduca: su estático no lleva firma.
68
+ *
69
+ * Como el cooldown, la caducidad **no despierta a nadie**: no toca `tick`, solo cambia lo que
70
+ * encontrará la próxima lectura. Un `<img>` ya pintado no se ve afectado —el navegador no
71
+ * vuelve a pedir una imagen que ya cargó—; lo que importa es que la siguiente vez que alguien
72
+ * pregunte reciba una URL con firma vigente.
73
+ */
74
+ class FotoPersonaService {
75
+ http = inject(HttpClient);
76
+ config = inject(FOTO_PERSONA_CONFIG, { optional: true });
77
+ loteMax = this.config?.loteMax ?? 200;
78
+ cooldownMs = this.config?.cooldownMs ?? 5000;
79
+ /**
80
+ * Vida de una URL en memoria. No es `readonly`: la cabecera `X-Fotos-Ttl` del manifiesto
81
+ * la reemplaza, de modo que bajar el TTL en el backend basta para que todos los clientes
82
+ * se ajusten en su siguiente petición, sin desplegar el frontend.
83
+ */
84
+ ttlUrlMs = this.config?.ttlUrlMs ?? 8 * 60 * 60 * 1000;
85
+ /** Último resultado conocido por clave (`preset:id`), incluidas las fallas transitorias. */
86
+ resultados = new Map();
87
+ /** Claves que el servidor ya resolvió con una respuesta válida: no se vuelven a pedir. */
88
+ confirmados = new Set();
89
+ /**
90
+ * Instante (ms) a partir del cual una clave confirmada deja de valer y hay que volver a
91
+ * pedirla. Solo entran aquí las que apuntan a una foto real: su URL va firmada y caduca.
92
+ * Una persona sin foto se resuelve con un estático —empaquetado en la app o servido por la
93
+ * ruta pública—, que no lleva firma y no tiene por qué volver a preguntarse.
94
+ */
95
+ caducan = new Map();
96
+ /** Claves encoladas o con la petición ya en vuelo: evita duplicar la petición. */
97
+ enCurso = new Set();
98
+ /** Claves que fallaron por red hace poco: en cooldown, `urlFoto()` todavía no las reintenta solo. */
99
+ enCooldown = new Set();
100
+ /** Ids pendientes de enviar en el próximo flush, agrupados por preset. */
101
+ pendientes = new Map();
102
+ flushProgramado = false;
103
+ /** Se incrementa cada vez que llega una respuesta (éxito o falla), para que los `computed()` abiertos se enteren. */
104
+ tick = signal(0, ...(ngDevMode ? [{ debugName: "tick" }] : /* istanbul ignore next */ []));
105
+ /**
106
+ * Signal reactiva con la foto de `iPersId` en el `preset` dado. Dispara la petición la
107
+ * primera vez que se lee, si en ese momento la clave no está confirmada, en curso ni en
108
+ * cooldown por una falla reciente (ver "Contrato de reintentos" arriba) — así que un
109
+ * `urlFoto()` nuevo creado después de que el cooldown de una falla anterior venció sí
110
+ * reintenta, aunque la signal de un componente que ya estaba montado cuando falló no se
111
+ * reintente sola con el simple paso del tiempo. `iPersId` en `null` no pide nada: devuelve el
112
+ * resultado vacío tal cual, y es responsabilidad del consumidor (p. ej. `FotoPersonaComponent`)
113
+ * decidir qué pintar en ese caso.
114
+ */
115
+ urlFoto(iPersId, preset) {
116
+ return computed(() => {
117
+ const id = iPersId();
118
+ this.tick();
119
+ if (id == null) {
120
+ return VACIO;
121
+ }
122
+ const clave = this.clave(id, preset);
123
+ if (!this.vigente(clave) && !this.enCurso.has(clave) && !this.enCooldown.has(clave)) {
124
+ this.solicitar(id, preset);
125
+ }
126
+ return this.resultados.get(clave) ?? { url: null, default: null, cargando: true };
127
+ });
128
+ }
129
+ /**
130
+ * Anuncia de golpe lo que una tabla va a necesitar, para que el primer
131
+ * `urlFoto()` de cada fila ya encuentre la respuesta en memoria. También
132
+ * es el mecanismo de reintento **inmediato** tras una falla de red: a
133
+ * diferencia de la lectura pasiva de `urlFoto()`, no espera el cooldown —
134
+ * vuelve a pedir cualquier id que no esté `confirmado`, aunque todavía
135
+ * esté en cooldown por una falla reciente.
136
+ */
137
+ precargar(ids, presets) {
138
+ for (const preset of presets) {
139
+ for (const id of ids) {
140
+ const clave = this.clave(id, preset);
141
+ if (this.vigente(clave) || this.enCurso.has(clave)) {
142
+ continue;
143
+ }
144
+ this.solicitar(id, preset);
145
+ }
146
+ }
147
+ }
148
+ /**
149
+ * URL pública del estático de falta (`natural-f`, `entidad`, …) para el `preset` dado. Pega
150
+ * en `GET {apiUrl}/imagenes/default/{nombre}/{preset}.{ext}` (sin autenticar, cacheado un
151
+ * año), con la misma base de API que usa el manifiesto. La extensión sale del preset, no del
152
+ * archivo en disco (que en el backend está mezclado entre `.png` y `.jpg`): así los
153
+ * consumidores nunca tienen que saber ni copiar esas imágenes.
154
+ */
155
+ urlDefecto(nombre, preset) {
156
+ const ext = EXTENSION_POR_PRESET[preset];
157
+ return `${this.apiUrl()}/imagenes/default/${nombre}/${preset}.${ext}`;
158
+ }
159
+ /**
160
+ * Ruta del asset local para el estático de falta `nombre`, o `null` si la app no configuró
161
+ * `assetsBasePath` — en ese caso el consumidor debe caer a `urlDefecto()`. A diferencia de
162
+ * `urlDefecto()`, esta ruta **no varía por preset**: las seis imágenes bundleadas son un solo
163
+ * archivo chico por nombre, no variantes generadas por tamaño (por eso no recibe `preset`).
164
+ * Un `nombre` que no sea uno de los seis conocidos cae a `falta`, igual que hace el componente
165
+ * cuando el manifiesto no trae `default`.
166
+ */
167
+ rutaLocalDefecto(nombre) {
168
+ const base = this.config?.assetsBasePath;
169
+ if (!base) {
170
+ return null;
171
+ }
172
+ const archivo = ARCHIVO_POR_DEFECTO[nombre] ?? ARCHIVO_POR_DEFECTO['falta'];
173
+ return `${base.replace(/\/+$/, '')}/${archivo}`;
174
+ }
175
+ /**
176
+ * Resuelve la base del API **en cada llamada**, nunca una sola vez: `apiUrl` puede ser una
177
+ * función que lee un valor que todavía no llegó cuando este servicio se inyectó (el servicio
178
+ * es `providedIn: 'root'`, así que su constructor corre una única vez, la primera vez que
179
+ * algo lo inyecta — capturar el valor ahí lo congelaría, típicamente en `undefined`/`''`, si
180
+ * la app resuelve su config de backend de forma asíncrona).
181
+ */
182
+ /**
183
+ * URL base del API, resuelta en CADA petición. Si falta, se lanza en vez de caer a cadena
184
+ * vacía: una base vacía produce peticiones relativas al servidor de desarrollo, que fallan
185
+ * con un 404 desconcertante en vez de señalar el cableado ausente. El caso real que motivó
186
+ * esto fue un `FOTO_PERSONA_CONFIG` duplicado por un entry point reexportado con ruta
187
+ * relativa: la app registraba un token y el servicio inyectaba otro, y el `optional: true`
188
+ * convertía ese error de empaquetado en un 404 silencioso.
189
+ */
190
+ apiUrl() {
191
+ const valor = this.config?.apiUrl;
192
+ const url = typeof valor === 'function' ? valor() : valor;
193
+ if (!url) {
194
+ throw new Error('FotoPersonaService: falta la URL del API. Registra provideFotoPersona({ apiUrl }) ' +
195
+ 'en los providers de la aplicación. Si ya está registrado, el token FOTO_PERSONA_CONFIG ' +
196
+ 'puede estar duplicado: comprueba que la raíz de @jvsoft/components reexporte foto-persona ' +
197
+ 'por nombre de paquete y no con ruta relativa.');
198
+ }
199
+ return url;
200
+ }
201
+ // --- Acumulación y envío ---
202
+ solicitar(id, preset) {
203
+ const clave = this.clave(id, preset);
204
+ if (this.enCurso.has(clave)) {
205
+ return;
206
+ }
207
+ this.enCurso.add(clave);
208
+ let idsDelPreset = this.pendientes.get(preset);
209
+ if (!idsDelPreset) {
210
+ idsDelPreset = new Set();
211
+ this.pendientes.set(preset, idsDelPreset);
212
+ }
213
+ idsDelPreset.add(id);
214
+ this.programarFlush();
215
+ }
216
+ programarFlush() {
217
+ if (this.flushProgramado) {
218
+ return;
219
+ }
220
+ this.flushProgramado = true;
221
+ queueMicrotask(() => this.flush());
222
+ }
223
+ flush() {
224
+ this.flushProgramado = false;
225
+ const lote = this.pendientes;
226
+ this.pendientes = new Map();
227
+ for (const [preset, idsSet] of lote) {
228
+ const ids = [...idsSet];
229
+ for (const trozo of this.enTrozos(ids, this.loteMax)) {
230
+ this.pedirManifiesto(trozo, preset);
231
+ }
232
+ }
233
+ }
234
+ pedirManifiesto(ids, preset) {
235
+ const url = `${this.apiUrl()}/imagenes/persona/lote`;
236
+ // `observe: 'response'` y no solo el cuerpo: hace falta leer la cabecera 'X-Fotos-Ttl',
237
+ // con la que el servidor dice cuánto valen las URL firmadas que acaba de entregar.
238
+ this.http.post(url, { ids, presets: [preset] }, { observe: 'response' }).subscribe({
239
+ next: (respuesta) => {
240
+ this.adoptarTtl(respuesta.headers.get('X-Fotos-Ttl'));
241
+ this.procesarRespuesta(ids, preset, respuesta.body ?? {});
242
+ },
243
+ error: (error) => this.procesarFallo(ids, preset, error),
244
+ });
245
+ }
246
+ procesarRespuesta(ids, preset, respuesta) {
247
+ for (const id of ids) {
248
+ const clave = this.clave(id, preset);
249
+ const item = respuesta[String(id)];
250
+ if (!item) {
251
+ // El servidor respondió pero no incluyó este id: se trata como sin foto,
252
+ // no como una falla (el servidor tuvo la oportunidad de resolverlo).
253
+ this.resultados.set(clave, VACIO);
254
+ }
255
+ else {
256
+ this.resultados.set(clave, {
257
+ url: item[preset] ?? null,
258
+ default: item['default'] ?? null,
259
+ cargando: false,
260
+ });
261
+ }
262
+ this.confirmados.add(clave);
263
+ // Solo caduca lo que apunta a una foto real: es lo único cuya URL va firmada.
264
+ const resultado = this.resultados.get(clave);
265
+ if (resultado?.url && !resultado.default) {
266
+ this.caducan.set(clave, Date.now() + this.ttlUrlMs);
267
+ }
268
+ else {
269
+ this.caducan.delete(clave);
270
+ }
271
+ this.enCurso.delete(clave);
272
+ }
273
+ this.tick.update((valor) => valor + 1);
274
+ }
275
+ procesarFallo(ids, preset, error) {
276
+ // eslint-disable-next-line no-console -- diagnóstico deliberado: una falla de manifiesto
277
+ // no debe pasar en silencio (un request malformado se ve igual que un corte de red sin esto).
278
+ console.warn('[FotoPersonaService] Falló el manifiesto de fotos; se reintentará tras el cooldown.', { ids, preset }, error);
279
+ for (const id of ids) {
280
+ const clave = this.clave(id, preset);
281
+ // No se marca `confirmado`: una falla de red no es una respuesta y no debe
282
+ // envenenar la memoria como si lo fuera. Dejamos un resultado transitorio de
283
+ // "sin foto" para no colgar al consumidor en `cargando`, y la clave entra en
284
+ // cooldown: `urlFoto()` la reintenta sola pasado ese tiempo (`precargar()` puede
285
+ // reintentar de inmediato, sin esperar).
286
+ this.resultados.set(clave, VACIO);
287
+ this.enCurso.delete(clave);
288
+ this.programarCooldown(clave);
289
+ }
290
+ this.tick.update((valor) => valor + 1);
291
+ }
292
+ /**
293
+ * Pasado `cooldownMs`, libera la clave para que la próxima vez que algo la pida — un
294
+ * `urlFoto()` nuevo, típicamente un componente que se crea — la vuelva a intentar.
295
+ *
296
+ * A propósito **no** toca `tick`: si lo hiciera, despertaría a todos los `computed()`
297
+ * abiertos que dependen de `tick` (incluidos los que fallaron), cada uno volvería a leer,
298
+ * el gate vería la clave ya libre y pediría de nuevo — y esa nueva falla programaría otro
299
+ * cooldown que, al vencer, repetiría el ciclo: un poll perpetuo contra el backend mientras el
300
+ * endpoint esté caído, uno por cada clave fallida, cada `cooldownMs`. Sin tocar `tick`, nada
301
+ * se despierta solo: liberar la clave solo cambia lo que un `urlFoto()` **nuevo** (o
302
+ * `precargar()`) va a encontrar la próxima vez que alguien pregunte por su cuenta.
303
+ */
304
+ programarCooldown(clave) {
305
+ this.enCooldown.add(clave);
306
+ setTimeout(() => {
307
+ this.enCooldown.delete(clave);
308
+ }, this.cooldownMs);
309
+ }
310
+ enTrozos(ids, tamano) {
311
+ if (tamano <= 0) {
312
+ return [ids];
313
+ }
314
+ const trozos = [];
315
+ for (let i = 0; i < ids.length; i += tamano) {
316
+ trozos.push(ids.slice(i, i + tamano));
317
+ }
318
+ return trozos;
319
+ }
320
+ /**
321
+ * Si la clave sigue sirviendo: confirmada por el servidor y, cuando apunta a una foto
322
+ * real, con la firma todavía dentro de su ventana. Una clave caducada se borra aquí mismo
323
+ * para que la siguiente lectura la pida de nuevo.
324
+ */
325
+ /**
326
+ * Adopta el TTL que anuncia el servidor. Se ignora lo que no sea un número positivo: una
327
+ * cabecera ausente (CORS sin exponerla, un backend anterior a este contrato) o corrupta no
328
+ * debe dejar el servicio con un TTL de cero, que pediría el manifiesto en cada lectura.
329
+ */
330
+ adoptarTtl(cabecera) {
331
+ const segundos = Number(cabecera);
332
+ if (Number.isFinite(segundos) && segundos > 0) {
333
+ this.ttlUrlMs = segundos * 1000;
334
+ }
335
+ }
336
+ vigente(clave) {
337
+ if (!this.confirmados.has(clave)) {
338
+ return false;
339
+ }
340
+ const caduca = this.caducan.get(clave);
341
+ if (caduca === undefined) {
342
+ return true; // estático de falta: no lleva firma, no caduca
343
+ }
344
+ if (Date.now() < caduca) {
345
+ return true;
346
+ }
347
+ this.confirmados.delete(clave);
348
+ this.caducan.delete(clave);
349
+ return false;
350
+ }
351
+ clave(id, preset) {
352
+ return `${preset}:${id}`;
353
+ }
354
+ static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.2.18", ngImport: i0, type: FotoPersonaService, deps: [], target: i0.ɵɵFactoryTarget.Injectable });
355
+ static ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "21.2.18", ngImport: i0, type: FotoPersonaService, providedIn: 'root' });
356
+ }
357
+ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.18", ngImport: i0, type: FotoPersonaService, decorators: [{
358
+ type: Injectable,
359
+ args: [{ providedIn: 'root' }]
360
+ }] });
361
+
362
+ /**
363
+ * Cablea `FOTO_PERSONA_CONFIG` en una sola llamada, igual que `provideEncryption()` cablea
364
+ * `ENCRYPTION_CONFIG`. Acepta un objeto estático o una **fábrica** que corre en contexto de
365
+ * inyección (puede usar `inject()` para leer la URL de un servicio de configuración del
366
+ * consumidor, como ya hace cada app con `ConfiguracionWebService`).
367
+ *
368
+ * La fábrica captura el *servicio* (para eso corre en contexto de inyección), pero `apiUrl`
369
+ * debería ser casi siempre un **thunk** (`() => string`), no un valor ya leído: en las apps de
370
+ * JVSoft, `ConfiguracionWebService.apiData` se resuelve de forma asíncrona (un
371
+ * `BehaviorSubject` que arranca en `null`), así que leerlo una sola vez aquí —al armar la
372
+ * fábrica, no al hacer la petición— lo congelaría en `undefined`/`''` para toda la sesión.
373
+ *
374
+ * @example
375
+ * // Config estática (base fija, sin partes asíncronas):
376
+ * provideFotoPersona({ apiUrl: 'https://api.example.com/api' })
377
+ *
378
+ * @example
379
+ * // Fábrica con inyección + thunk (recomendado): `cfg.backendApi` se relee en cada petición,
380
+ * // así que aunque `apiData` llegue después, la primera petición real ya lo ve resuelto.
381
+ * provideFotoPersona(() => {
382
+ * const cfg = inject(ConfiguracionWebService);
383
+ * return { apiUrl: () => cfg.backendApi };
384
+ * })
385
+ */
386
+ function provideFotoPersona(config) {
387
+ return makeEnvironmentProviders([
388
+ typeof config === 'function'
389
+ ? { provide: FOTO_PERSONA_CONFIG, useFactory: config }
390
+ : { provide: FOTO_PERSONA_CONFIG, useValue: config },
391
+ ]);
392
+ }
393
+
394
+ /** Traduce el tamaño semántico al preset que hay que pedirle al servicio. */
395
+ const PRESET_POR_TAMANO = {
396
+ tabla: 'avatar',
397
+ tarjeta: 'avatar-grande',
398
+ ficha: 'full',
399
+ };
400
+ /**
401
+ * `width`/`height` que se fijan en el `<img>` (o en el placeholder mientras
402
+ * carga) para que el navegador reserve el hueco y la tabla no salte.
403
+ * `ficha` no tiene un contenedor fijo en el diseño, pero igual se fija al
404
+ * tamaño del original de hoy (160×225) para no perder la reserva de espacio.
405
+ */
406
+ const DIMENSION_POR_TAMANO = {
407
+ tabla: { ancho: 36, alto: 36 },
408
+ tarjeta: { ancho: 80, alto: 80 },
409
+ ficha: { ancho: 160, alto: 225 },
410
+ };
411
+ /**
412
+ * `<jvs-foto-persona>` — foto de una persona por `iPersId`, con un tamaño
413
+ * semántico (`tabla`, `tarjeta`, `ficha`) en vez de un preset o unos píxeles.
414
+ * Consume `FotoPersonaService` (que acumula y cachea las peticiones); este
415
+ * componente solo traduce tamaño → preset y decide qué pintar mientras carga
416
+ * o cuando no hay foto real.
417
+ */
418
+ class FotoPersonaComponent {
419
+ fotoPersonaService = inject(FotoPersonaService);
420
+ /**
421
+ * Id de la persona. En `null` (por ejemplo, un formulario donde todavía no se eligió a
422
+ * nadie) el componente **no pide nada al servicio**, pero sí pinta el estático genérico
423
+ * `falta` en el tamaño que le toca a `tamano` — reserva el mismo hueco y evita un salto de
424
+ * layout cuando se elige a alguien, en vez de dejar una caja vacía.
425
+ */
426
+ iPersId = input(null, ...(ngDevMode ? [{ debugName: "iPersId" }] : /* istanbul ignore next */ []));
427
+ tamano = input('tabla', ...(ngDevMode ? [{ debugName: "tamano" }] : /* istanbul ignore next */ []));
428
+ alt = input('Fotografía', ...(ngDevMode ? [{ debugName: "alt" }] : /* istanbul ignore next */ []));
429
+ clases = input('', ...(ngDevMode ? [{ debugName: "clases" }] : /* istanbul ignore next */ []));
430
+ preset = computed(() => PRESET_POR_TAMANO[this.tamano()], ...(ngDevMode ? [{ debugName: "preset" }] : /* istanbul ignore next */ []));
431
+ dimension = computed(() => DIMENSION_POR_TAMANO[this.tamano()], ...(ngDevMode ? [{ debugName: "dimension" }] : /* istanbul ignore next */ []));
432
+ /** Envuelve la signal que devuelve el servicio (que puede cambiar de instancia si cambia el preset). */
433
+ foto = computed(() => this.fotoPersonaService.urlFoto(this.iPersId, this.preset())(), ...(ngDevMode ? [{ debugName: "foto" }] : /* istanbul ignore next */ []));
434
+ /**
435
+ * URL a pintar, o `null` mientras carga (todavía sin foto real ni
436
+ * estático que mostrar). Prioridad: foto real → estático que indicó el
437
+ * servidor → estático genérico `falta` cuando ni eso hay (falla de red
438
+ * ya resuelta, o servidor que no devolvió nada).
439
+ *
440
+ * El estático de falta prefiere el asset local (`FotoPersonaService.rutaLocalDefecto()`) si
441
+ * la app configuró `assetsBasePath` — las seis imágenes son chicas e idénticas para todas
442
+ * las instalaciones, así que empaquetarlas evita una petición de red por instalación con
443
+ * caché fría. Si la app no configuró esa ruta, cae al backend (`urlDefecto()`,
444
+ * `GET /api/imagenes/default/{nombre}/{preset}.{ext}`), como siempre: ese es el comportamiento
445
+ * sin cambios para quien todavía no copió los seis archivos.
446
+ */
447
+ src = computed(() => {
448
+ const resultado = this.foto();
449
+ // `default` con valor significa que esta persona NO tiene foto propia, y se comprueba
450
+ // ANTES que `url`: el manifiesto trae también la URL de la imagen genérica, así que si
451
+ // se mirara `url` primero siempre ganaría la del servidor y el asset empaquetado no se
452
+ // usaría jamás — que es justo lo que empaquetarlo venía a evitar.
453
+ if (resultado.default) {
454
+ return this.fotoPersonaService.rutaLocalDefecto(resultado.default)
455
+ ?? resultado.url
456
+ ?? this.fotoPersonaService.urlDefecto(resultado.default, this.preset());
457
+ }
458
+ if (resultado.url) {
459
+ return resultado.url;
460
+ }
461
+ if (resultado.cargando) {
462
+ return null;
463
+ }
464
+ // Ni foto ni respuesta del servidor (falla de red ya resuelta): último recurso genérico.
465
+ return this.fotoPersonaService.rutaLocalDefecto('falta')
466
+ ?? this.fotoPersonaService.urlDefecto('falta', this.preset());
467
+ }, ...(ngDevMode ? [{ debugName: "src" }] : /* istanbul ignore next */ []));
468
+ static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.2.18", ngImport: i0, type: FotoPersonaComponent, deps: [], target: i0.ɵɵFactoryTarget.Component });
469
+ static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "17.0.0", version: "21.2.18", type: FotoPersonaComponent, isStandalone: true, selector: "jvs-foto-persona", inputs: { iPersId: { classPropertyName: "iPersId", publicName: "iPersId", isSignal: true, isRequired: false, transformFunction: null }, tamano: { classPropertyName: "tamano", publicName: "tamano", isSignal: true, isRequired: false, transformFunction: null }, alt: { classPropertyName: "alt", publicName: "alt", isSignal: true, isRequired: false, transformFunction: null }, clases: { classPropertyName: "clases", publicName: "clases", isSignal: true, isRequired: false, transformFunction: null } }, ngImport: i0, template: "@if (src(); as urlImagen) {\n <img\n [src]=\"urlImagen\"\n [alt]=\"alt()\"\n [width]=\"dimension().ancho\"\n [height]=\"dimension().alto\"\n [class]=\"clases()\"\n loading=\"lazy\"\n decoding=\"async\"\n />\n} @else {\n <div\n class=\"jvs-foto-persona__placeholder\"\n [class]=\"clases()\"\n [style.width.px]=\"dimension().ancho\"\n [style.height.px]=\"dimension().alto\"\n [attr.aria-label]=\"alt()\"\n ></div>\n}\n", styles: [":host{display:inline-block;line-height:0}img,.jvs-foto-persona__placeholder{display:block}img{object-fit:cover}.jvs-foto-persona__placeholder{background-color:#e5e7eb}\n"] });
470
+ }
471
+ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.18", ngImport: i0, type: FotoPersonaComponent, decorators: [{
472
+ type: Component,
473
+ args: [{ selector: 'jvs-foto-persona', standalone: true, template: "@if (src(); as urlImagen) {\n <img\n [src]=\"urlImagen\"\n [alt]=\"alt()\"\n [width]=\"dimension().ancho\"\n [height]=\"dimension().alto\"\n [class]=\"clases()\"\n loading=\"lazy\"\n decoding=\"async\"\n />\n} @else {\n <div\n class=\"jvs-foto-persona__placeholder\"\n [class]=\"clases()\"\n [style.width.px]=\"dimension().ancho\"\n [style.height.px]=\"dimension().alto\"\n [attr.aria-label]=\"alt()\"\n ></div>\n}\n", styles: [":host{display:inline-block;line-height:0}img,.jvs-foto-persona__placeholder{display:block}img{object-fit:cover}.jvs-foto-persona__placeholder{background-color:#e5e7eb}\n"] }]
474
+ }], propDecorators: { iPersId: [{ type: i0.Input, args: [{ isSignal: true, alias: "iPersId", required: false }] }], tamano: [{ type: i0.Input, args: [{ isSignal: true, alias: "tamano", required: false }] }], alt: [{ type: i0.Input, args: [{ isSignal: true, alias: "alt", required: false }] }], clases: [{ type: i0.Input, args: [{ isSignal: true, alias: "clases", required: false }] }] } });
475
+
476
+ /**
477
+ * Generated bundle index. Do not edit.
478
+ */
479
+
480
+ export { FOTO_PERSONA_CONFIG, FotoPersonaComponent, FotoPersonaService, provideFotoPersona };
481
+ //# sourceMappingURL=jvsoft-components-foto-persona.mjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"jvsoft-components-foto-persona.mjs","sources":["../../../projects/components/foto-persona/foto-persona.service.ts","../../../projects/components/foto-persona/provide-foto-persona.ts","../../../projects/components/foto-persona/foto-persona.component.ts","../../../projects/components/foto-persona/foto-persona.component.html","../../../projects/components/foto-persona/jvsoft-components-foto-persona.ts"],"sourcesContent":["import { computed, inject, Injectable, InjectionToken, signal, Signal } from '@angular/core';\nimport { HttpClient } from '@angular/common/http';\n\n/**\n * Tamaños de imagen que el backend sabe generar. Coincide 1:1 con el enum PHP\n * `JvSoft\\Utils\\Fotos\\Preset`; como son 5 valores fijos y ya versionados en el\n * contrato del backend, un union type basta y evita mantener dos definiciones\n * sincronizadas a mano.\n */\nexport type Preset = 'thumbnail' | 'avatar' | 'avatar-grande' | 'full' | 'medium';\n\n/** Resultado resuelto (o en curso) para un `iPersId` + `preset`. */\nexport interface UrlFoto {\n /** URL absoluta de la foto real, o `null` si no hay una. */\n url: string | null;\n /** Nombre del estático de falta (`natural-f`, `entidad`, …) cuando no hay foto real. */\n default: string | null;\n /** `true` mientras el manifiesto que resuelve este id todavía no responde. */\n cargando: boolean;\n}\n\n/** Configuración inyectable del servicio. Sigue el patrón de `ENCRYPTION_CONFIG`. */\nexport interface FotoPersonaConfig {\n /**\n * Base del API del backend — el mismo valor que la app ya resuelve como `backendApi`\n * (host + `/api`, o lo que sea que cada instalación configure; **incluye** el `/api`, este\n * servicio no le agrega uno propio). Sin slash final. Por defecto relativo (mismo origen).\n *\n * Puede ser un `string` fijo o una función que se llama **en cada petición**: úsala cuando el\n * valor real (p. ej. `ConfiguracionWebService.apiData`) se resuelve de forma asíncrona,\n * después de que este servicio ya se haya inyectado — un `string` capturado en el momento del\n * `provide*()` se congelaría con el valor que hubiera en ese instante (frecuentemente\n * `undefined`, antes de que cargue el `apiData`).\n */\n apiUrl?: string | (() => string);\n /** Tope de ids por petición de manifiesto. Debe ser <= `jvsoft.fotos.lote_max` del backend (200 por defecto). */\n loteMax?: number;\n /**\n * Cuánto tiempo (ms) espera una clave que falló por red antes de volverse elegible para\n * un reintento automático en una lectura posterior de `urlFoto()`. Evita que un componente\n * que se re-renderiza seguido bombardee el backend. 5000 ms por defecto.\n */\n cooldownMs?: number;\n /**\n * Carpeta de assets donde la app consumidora empaquetó las seis imágenes de falta\n * (`natural-m`, `natural-f`, `entidad`, `extranjero-m`, `extranjero-f`, `falta`), sin slash\n * final — típicamente `assets/img/falta` si siguió la convención de `angular.json` de copiar\n * `assets/` a la raíz servida. **Sin configurar (el default), el comportamiento no cambia**:\n * el estático de falta se sigue pidiendo al backend (`urlDefecto()`), como hasta ahora — así\n * una app que todavía no copió los seis archivos no se rompe. Configurarla evita esa petición\n * de red: las imágenes son idénticas para todas las instalaciones y no valía la pena traerlas\n * por HTTP en cada caché fría. Ver `rutaLocalDefecto()`.\n */\n assetsBasePath?: string;\n /**\n * Cuánto tiempo (ms) se reutiliza en memoria una URL de foto antes de volver a pedirla al\n * manifiesto. Existe porque esas URL van **firmadas** y caducan: guardarlas para siempre\n * acabaría pintando `<img>` con una firma vencida.\n *\n * Normalmente no hace falta tocarlo. El manifiesto anuncia el valor bueno en la cabecera\n * `X-Fotos-Ttl` y el servicio lo adopta en cuanto lo ve, así que basta con cambiarlo en el\n * backend. Esto es solo el valor inicial, para la primera petición y para cuando la\n * cabecera no llega —por ejemplo si el backend sirve en otro origen y nadie la expuso en\n * `exposed_headers` de CORS—. 8 h por defecto, un escalón por debajo de la caché del\n * navegador, que a su vez está por debajo de la vida de la firma.\n */\n ttlUrlMs?: number;\n}\n\nexport const FOTO_PERSONA_CONFIG = new InjectionToken<FotoPersonaConfig>('FOTO_PERSONA_CONFIG');\n\nconst VACIO: UrlFoto = { url: null, default: null, cargando: false };\n\n/**\n * Extensión que el backend emite para cada preset en `GET /api/imagenes/default/…`: los tres\n * presets cuadrados chicos son WebP; `full` y `medium` hoy devuelven el original JPEG. Debe\n * seguir a `FotografiaPersonaController::extensionEsperada()` del backend si eso cambia.\n */\nconst EXTENSION_POR_PRESET: Record<Preset, 'webp' | 'jpg'> = {\n thumbnail: 'webp',\n avatar: 'webp',\n 'avatar-grande': 'webp',\n full: 'jpg',\n medium: 'jpg',\n};\n\n/**\n * Nombre de archivo real de cada estático de falta, tal como vive hoy en\n * `backend/public/img/falta/`. Existe SOLO por esto: las extensiones están mezcladas —\n * `natural-m`, `natural-f`, `entidad`, `extranjero-m` y `extranjero-f` son `.png`, pero `falta`\n * (el último recurso) es `.jpg`. Un consumidor que arme `${nombre}.png` a ciegas funciona para\n * cinco de los seis y se rompe justo en el que nunca puede fallar. Este mapa es la única fuente\n * de verdad de esos nombres de archivo para assets locales: que nadie vuelva a reconstruirlos.\n * (No confundir con `EXTENSION_POR_PRESET`: ese deriva la extensión que sirve el *backend* según\n * el *preset* pedido; este es el archivo fijo, sin variantes por preset, que empaqueta la app.)\n */\nconst ARCHIVO_POR_DEFECTO: Record<string, string> = {\n 'natural-m': 'natural-m.png',\n 'natural-f': 'natural-f.png',\n entidad: 'entidad.png',\n 'extranjero-m': 'extranjero-m.png',\n 'extranjero-f': 'extranjero-f.png',\n falta: 'falta.jpg',\n};\n\n/** Item del manifiesto para un id: una clave por preset pedido, más `default` opcional. */\ntype ManifiestoItem = Record<string, string | null | undefined>;\ntype ManifiestoRespuesta = Record<string, ManifiestoItem>;\n\n/**\n * Acumula las peticiones de foto de persona que llegan en el mismo ciclo de\n * detección de cambios y las resuelve con **un** `POST /api/imagenes/persona/lote`\n * (o varios si el lote excede `loteMax`), en vez de una petición HTTP por\n * componente. Ver diseño en `docs/superpowers/specs/2026-09-06-fotos-s3-central-design.md` § 8.3.\n *\n * ## Contrato de reintentos\n * Hay una diferencia entre «el servidor contestó que no hay foto» (una respuesta real, se\n * cachea para siempre) y «no pudimos ni preguntar» (una falla de red, que no es una respuesta y\n * no debe tratarse como una). Por eso:\n * - Una respuesta del servidor (con foto, o sin foto pero con `default`) queda **confirmada**:\n * nunca se vuelve a pedir.\n * - Una falla de red deja el resultado inmediato en «sin foto» (no se cuelga en `cargando`, no\n * lanza), pero **no** queda confirmada. La clave entra en un cooldown corto (`cooldownMs`, 5 s\n * por defecto) durante el cual ni `urlFoto()` ni el paso del tiempo la reintentan solos.\n * - Pasado el cooldown, la clave queda **elegible**, no se reintenta sola: hace falta que algo\n * la vuelva a pedir — típicamente un `urlFoto()` nuevo (un componente que se crea) o una\n * llamada a `precargar()`. El cooldown expirando **no despierta a nadie** por sí mismo (no\n * toca `tick`, ver `programarCooldown()`): si lo hiciera, cada falla programaría su propio\n * cooldown, que al vencer despertaría a los mismos consumidores fallidos, que volverían a\n * pedir, fallarían de nuevo y programarían otro cooldown — un poll perpetuo contra un backend\n * caído. Una lectura de verdad nueva (navegación, tabla que se recarga con componentes nuevos,\n * `precargar()`) es lo único que reintenta.\n * - `precargar()` reintenta claves no confirmadas de inmediato, sin esperar el cooldown — para\n * un botón \"reintentar\" o para precargar una tabla a propósito.\n *\n * ## Caducidad\n * Las URL de foto real van firmadas por el backend y vencen (12 h como máximo), así que\n * \"confirmada\" no significa \"para siempre\": una entrada con foto real vive `ttlUrlMs` —o lo\n * que anuncie la cabecera `X-Fotos-Ttl`, que manda— y después se vuelve a pedir. Una persona\n * sin foto no caduca: su estático no lleva firma.\n *\n * Como el cooldown, la caducidad **no despierta a nadie**: no toca `tick`, solo cambia lo que\n * encontrará la próxima lectura. Un `<img>` ya pintado no se ve afectado —el navegador no\n * vuelve a pedir una imagen que ya cargó—; lo que importa es que la siguiente vez que alguien\n * pregunte reciba una URL con firma vigente.\n */\n@Injectable({ providedIn: 'root' })\nexport class FotoPersonaService {\n private readonly http = inject(HttpClient);\n private readonly config = inject(FOTO_PERSONA_CONFIG, { optional: true });\n\n private readonly loteMax = this.config?.loteMax ?? 200;\n private readonly cooldownMs = this.config?.cooldownMs ?? 5000;\n\n /**\n * Vida de una URL en memoria. No es `readonly`: la cabecera `X-Fotos-Ttl` del manifiesto\n * la reemplaza, de modo que bajar el TTL en el backend basta para que todos los clientes\n * se ajusten en su siguiente petición, sin desplegar el frontend.\n */\n private ttlUrlMs = this.config?.ttlUrlMs ?? 8 * 60 * 60 * 1000;\n\n /** Último resultado conocido por clave (`preset:id`), incluidas las fallas transitorias. */\n private readonly resultados = new Map<string, UrlFoto>();\n /** Claves que el servidor ya resolvió con una respuesta válida: no se vuelven a pedir. */\n private readonly confirmados = new Set<string>();\n /**\n * Instante (ms) a partir del cual una clave confirmada deja de valer y hay que volver a\n * pedirla. Solo entran aquí las que apuntan a una foto real: su URL va firmada y caduca.\n * Una persona sin foto se resuelve con un estático —empaquetado en la app o servido por la\n * ruta pública—, que no lleva firma y no tiene por qué volver a preguntarse.\n */\n private readonly caducan = new Map<string, number>();\n /** Claves encoladas o con la petición ya en vuelo: evita duplicar la petición. */\n private readonly enCurso = new Set<string>();\n /** Claves que fallaron por red hace poco: en cooldown, `urlFoto()` todavía no las reintenta solo. */\n private readonly enCooldown = new Set<string>();\n /** Ids pendientes de enviar en el próximo flush, agrupados por preset. */\n private pendientes = new Map<Preset, Set<number>>();\n private flushProgramado = false;\n\n /** Se incrementa cada vez que llega una respuesta (éxito o falla), para que los `computed()` abiertos se enteren. */\n private readonly tick = signal(0);\n\n /**\n * Signal reactiva con la foto de `iPersId` en el `preset` dado. Dispara la petición la\n * primera vez que se lee, si en ese momento la clave no está confirmada, en curso ni en\n * cooldown por una falla reciente (ver \"Contrato de reintentos\" arriba) — así que un\n * `urlFoto()` nuevo creado después de que el cooldown de una falla anterior venció sí\n * reintenta, aunque la signal de un componente que ya estaba montado cuando falló no se\n * reintente sola con el simple paso del tiempo. `iPersId` en `null` no pide nada: devuelve el\n * resultado vacío tal cual, y es responsabilidad del consumidor (p. ej. `FotoPersonaComponent`)\n * decidir qué pintar en ese caso.\n */\n urlFoto(iPersId: Signal<number | null>, preset: Preset): Signal<UrlFoto> {\n return computed(() => {\n const id = iPersId();\n this.tick();\n\n if (id == null) {\n return VACIO;\n }\n\n const clave = this.clave(id, preset);\n\n if (!this.vigente(clave) && !this.enCurso.has(clave) && !this.enCooldown.has(clave)) {\n this.solicitar(id, preset);\n }\n\n return this.resultados.get(clave) ?? { url: null, default: null, cargando: true };\n });\n }\n\n /**\n * Anuncia de golpe lo que una tabla va a necesitar, para que el primer\n * `urlFoto()` de cada fila ya encuentre la respuesta en memoria. También\n * es el mecanismo de reintento **inmediato** tras una falla de red: a\n * diferencia de la lectura pasiva de `urlFoto()`, no espera el cooldown —\n * vuelve a pedir cualquier id que no esté `confirmado`, aunque todavía\n * esté en cooldown por una falla reciente.\n */\n precargar(ids: number[], presets: Preset[]): void {\n for (const preset of presets) {\n for (const id of ids) {\n const clave = this.clave(id, preset);\n if (this.vigente(clave) || this.enCurso.has(clave)) {\n continue;\n }\n this.solicitar(id, preset);\n }\n }\n }\n\n /**\n * URL pública del estático de falta (`natural-f`, `entidad`, …) para el `preset` dado. Pega\n * en `GET {apiUrl}/imagenes/default/{nombre}/{preset}.{ext}` (sin autenticar, cacheado un\n * año), con la misma base de API que usa el manifiesto. La extensión sale del preset, no del\n * archivo en disco (que en el backend está mezclado entre `.png` y `.jpg`): así los\n * consumidores nunca tienen que saber ni copiar esas imágenes.\n */\n urlDefecto(nombre: string, preset: Preset): string {\n const ext = EXTENSION_POR_PRESET[preset];\n return `${this.apiUrl()}/imagenes/default/${nombre}/${preset}.${ext}`;\n }\n\n /**\n * Ruta del asset local para el estático de falta `nombre`, o `null` si la app no configuró\n * `assetsBasePath` — en ese caso el consumidor debe caer a `urlDefecto()`. A diferencia de\n * `urlDefecto()`, esta ruta **no varía por preset**: las seis imágenes bundleadas son un solo\n * archivo chico por nombre, no variantes generadas por tamaño (por eso no recibe `preset`).\n * Un `nombre` que no sea uno de los seis conocidos cae a `falta`, igual que hace el componente\n * cuando el manifiesto no trae `default`.\n */\n rutaLocalDefecto(nombre: string): string | null {\n const base = this.config?.assetsBasePath;\n if (!base) {\n return null;\n }\n\n const archivo = ARCHIVO_POR_DEFECTO[nombre] ?? ARCHIVO_POR_DEFECTO['falta'];\n return `${base.replace(/\\/+$/, '')}/${archivo}`;\n }\n\n /**\n * Resuelve la base del API **en cada llamada**, nunca una sola vez: `apiUrl` puede ser una\n * función que lee un valor que todavía no llegó cuando este servicio se inyectó (el servicio\n * es `providedIn: 'root'`, así que su constructor corre una única vez, la primera vez que\n * algo lo inyecta — capturar el valor ahí lo congelaría, típicamente en `undefined`/`''`, si\n * la app resuelve su config de backend de forma asíncrona).\n */\n /**\n * URL base del API, resuelta en CADA petición. Si falta, se lanza en vez de caer a cadena\n * vacía: una base vacía produce peticiones relativas al servidor de desarrollo, que fallan\n * con un 404 desconcertante en vez de señalar el cableado ausente. El caso real que motivó\n * esto fue un `FOTO_PERSONA_CONFIG` duplicado por un entry point reexportado con ruta\n * relativa: la app registraba un token y el servicio inyectaba otro, y el `optional: true`\n * convertía ese error de empaquetado en un 404 silencioso.\n */\n private apiUrl(): string {\n const valor = this.config?.apiUrl;\n const url = typeof valor === 'function' ? valor() : valor;\n\n if (!url) {\n throw new Error(\n 'FotoPersonaService: falta la URL del API. Registra provideFotoPersona({ apiUrl }) ' +\n 'en los providers de la aplicación. Si ya está registrado, el token FOTO_PERSONA_CONFIG ' +\n 'puede estar duplicado: comprueba que la raíz de @jvsoft/components reexporte foto-persona ' +\n 'por nombre de paquete y no con ruta relativa.'\n );\n }\n\n return url;\n }\n\n // --- Acumulación y envío ---\n\n private solicitar(id: number, preset: Preset): void {\n const clave = this.clave(id, preset);\n if (this.enCurso.has(clave)) {\n return;\n }\n this.enCurso.add(clave);\n\n let idsDelPreset = this.pendientes.get(preset);\n if (!idsDelPreset) {\n idsDelPreset = new Set<number>();\n this.pendientes.set(preset, idsDelPreset);\n }\n idsDelPreset.add(id);\n\n this.programarFlush();\n }\n\n private programarFlush(): void {\n if (this.flushProgramado) {\n return;\n }\n this.flushProgramado = true;\n queueMicrotask(() => this.flush());\n }\n\n private flush(): void {\n this.flushProgramado = false;\n const lote = this.pendientes;\n this.pendientes = new Map();\n\n for (const [preset, idsSet] of lote) {\n const ids = [...idsSet];\n for (const trozo of this.enTrozos(ids, this.loteMax)) {\n this.pedirManifiesto(trozo, preset);\n }\n }\n }\n\n private pedirManifiesto(ids: number[], preset: Preset): void {\n const url = `${this.apiUrl()}/imagenes/persona/lote`;\n\n // `observe: 'response'` y no solo el cuerpo: hace falta leer la cabecera 'X-Fotos-Ttl',\n // con la que el servidor dice cuánto valen las URL firmadas que acaba de entregar.\n this.http.post<ManifiestoRespuesta>(url, { ids, presets: [preset] }, { observe: 'response' }).subscribe({\n next: (respuesta) => {\n this.adoptarTtl(respuesta.headers.get('X-Fotos-Ttl'));\n this.procesarRespuesta(ids, preset, respuesta.body ?? {});\n },\n error: (error) => this.procesarFallo(ids, preset, error),\n });\n }\n\n private procesarRespuesta(ids: number[], preset: Preset, respuesta: ManifiestoRespuesta): void {\n for (const id of ids) {\n const clave = this.clave(id, preset);\n const item = respuesta[String(id)];\n\n if (!item) {\n // El servidor respondió pero no incluyó este id: se trata como sin foto,\n // no como una falla (el servidor tuvo la oportunidad de resolverlo).\n this.resultados.set(clave, VACIO);\n } else {\n this.resultados.set(clave, {\n url: item[preset] ?? null,\n default: item['default'] ?? null,\n cargando: false,\n });\n }\n\n this.confirmados.add(clave);\n // Solo caduca lo que apunta a una foto real: es lo único cuya URL va firmada.\n const resultado = this.resultados.get(clave);\n if (resultado?.url && !resultado.default) {\n this.caducan.set(clave, Date.now() + this.ttlUrlMs);\n } else {\n this.caducan.delete(clave);\n }\n this.enCurso.delete(clave);\n }\n\n this.tick.update((valor) => valor + 1);\n }\n\n private procesarFallo(ids: number[], preset: Preset, error: unknown): void {\n // eslint-disable-next-line no-console -- diagnóstico deliberado: una falla de manifiesto\n // no debe pasar en silencio (un request malformado se ve igual que un corte de red sin esto).\n console.warn('[FotoPersonaService] Falló el manifiesto de fotos; se reintentará tras el cooldown.', { ids, preset }, error);\n\n for (const id of ids) {\n const clave = this.clave(id, preset);\n // No se marca `confirmado`: una falla de red no es una respuesta y no debe\n // envenenar la memoria como si lo fuera. Dejamos un resultado transitorio de\n // \"sin foto\" para no colgar al consumidor en `cargando`, y la clave entra en\n // cooldown: `urlFoto()` la reintenta sola pasado ese tiempo (`precargar()` puede\n // reintentar de inmediato, sin esperar).\n this.resultados.set(clave, VACIO);\n this.enCurso.delete(clave);\n this.programarCooldown(clave);\n }\n\n this.tick.update((valor) => valor + 1);\n }\n\n /**\n * Pasado `cooldownMs`, libera la clave para que la próxima vez que algo la pida — un\n * `urlFoto()` nuevo, típicamente un componente que se crea — la vuelva a intentar.\n *\n * A propósito **no** toca `tick`: si lo hiciera, despertaría a todos los `computed()`\n * abiertos que dependen de `tick` (incluidos los que fallaron), cada uno volvería a leer,\n * el gate vería la clave ya libre y pediría de nuevo — y esa nueva falla programaría otro\n * cooldown que, al vencer, repetiría el ciclo: un poll perpetuo contra el backend mientras el\n * endpoint esté caído, uno por cada clave fallida, cada `cooldownMs`. Sin tocar `tick`, nada\n * se despierta solo: liberar la clave solo cambia lo que un `urlFoto()` **nuevo** (o\n * `precargar()`) va a encontrar la próxima vez que alguien pregunte por su cuenta.\n */\n private programarCooldown(clave: string): void {\n this.enCooldown.add(clave);\n setTimeout(() => {\n this.enCooldown.delete(clave);\n }, this.cooldownMs);\n }\n\n private enTrozos(ids: number[], tamano: number): number[][] {\n if (tamano <= 0) {\n return [ids];\n }\n const trozos: number[][] = [];\n for (let i = 0; i < ids.length; i += tamano) {\n trozos.push(ids.slice(i, i + tamano));\n }\n return trozos;\n }\n\n /**\n * Si la clave sigue sirviendo: confirmada por el servidor y, cuando apunta a una foto\n * real, con la firma todavía dentro de su ventana. Una clave caducada se borra aquí mismo\n * para que la siguiente lectura la pida de nuevo.\n */\n /**\n * Adopta el TTL que anuncia el servidor. Se ignora lo que no sea un número positivo: una\n * cabecera ausente (CORS sin exponerla, un backend anterior a este contrato) o corrupta no\n * debe dejar el servicio con un TTL de cero, que pediría el manifiesto en cada lectura.\n */\n private adoptarTtl(cabecera: string | null): void {\n const segundos = Number(cabecera);\n if (Number.isFinite(segundos) && segundos > 0) {\n this.ttlUrlMs = segundos * 1000;\n }\n }\n\n private vigente(clave: string): boolean {\n if (!this.confirmados.has(clave)) {\n return false;\n }\n\n const caduca = this.caducan.get(clave);\n if (caduca === undefined) {\n return true; // estático de falta: no lleva firma, no caduca\n }\n\n if (Date.now() < caduca) {\n return true;\n }\n\n this.confirmados.delete(clave);\n this.caducan.delete(clave);\n return false;\n }\n\n private clave(id: number, preset: Preset): string {\n return `${preset}:${id}`;\n }\n}\n","import { EnvironmentProviders, makeEnvironmentProviders } from '@angular/core';\nimport { FOTO_PERSONA_CONFIG, FotoPersonaConfig } from './foto-persona.service';\n\n/**\n * Cablea `FOTO_PERSONA_CONFIG` en una sola llamada, igual que `provideEncryption()` cablea\n * `ENCRYPTION_CONFIG`. Acepta un objeto estático o una **fábrica** que corre en contexto de\n * inyección (puede usar `inject()` para leer la URL de un servicio de configuración del\n * consumidor, como ya hace cada app con `ConfiguracionWebService`).\n *\n * La fábrica captura el *servicio* (para eso corre en contexto de inyección), pero `apiUrl`\n * debería ser casi siempre un **thunk** (`() => string`), no un valor ya leído: en las apps de\n * JVSoft, `ConfiguracionWebService.apiData` se resuelve de forma asíncrona (un\n * `BehaviorSubject` que arranca en `null`), así que leerlo una sola vez aquí —al armar la\n * fábrica, no al hacer la petición— lo congelaría en `undefined`/`''` para toda la sesión.\n *\n * @example\n * // Config estática (base fija, sin partes asíncronas):\n * provideFotoPersona({ apiUrl: 'https://api.example.com/api' })\n *\n * @example\n * // Fábrica con inyección + thunk (recomendado): `cfg.backendApi` se relee en cada petición,\n * // así que aunque `apiData` llegue después, la primera petición real ya lo ve resuelto.\n * provideFotoPersona(() => {\n * const cfg = inject(ConfiguracionWebService);\n * return { apiUrl: () => cfg.backendApi };\n * })\n */\nexport function provideFotoPersona(config: FotoPersonaConfig | (() => FotoPersonaConfig)): EnvironmentProviders {\n return makeEnvironmentProviders([\n typeof config === 'function'\n ? { provide: FOTO_PERSONA_CONFIG, useFactory: config }\n : { provide: FOTO_PERSONA_CONFIG, useValue: config },\n ]);\n}\n","import { Component, computed, inject, input } from '@angular/core';\nimport { FotoPersonaService, Preset } from './foto-persona.service';\n\n/** Tamaño semántico: la plantilla ya no pide un preset ni un número de píxeles. */\nexport type TamanoFoto = 'tabla' | 'tarjeta' | 'ficha';\n\ninterface DimensionFoto {\n ancho: number;\n alto: number;\n}\n\n/** Traduce el tamaño semántico al preset que hay que pedirle al servicio. */\nconst PRESET_POR_TAMANO: Record<TamanoFoto, Preset> = {\n tabla: 'avatar',\n tarjeta: 'avatar-grande',\n ficha: 'full',\n};\n\n/**\n * `width`/`height` que se fijan en el `<img>` (o en el placeholder mientras\n * carga) para que el navegador reserve el hueco y la tabla no salte.\n * `ficha` no tiene un contenedor fijo en el diseño, pero igual se fija al\n * tamaño del original de hoy (160×225) para no perder la reserva de espacio.\n */\nconst DIMENSION_POR_TAMANO: Record<TamanoFoto, DimensionFoto> = {\n tabla: { ancho: 36, alto: 36 },\n tarjeta: { ancho: 80, alto: 80 },\n ficha: { ancho: 160, alto: 225 },\n};\n\n/**\n * `<jvs-foto-persona>` — foto de una persona por `iPersId`, con un tamaño\n * semántico (`tabla`, `tarjeta`, `ficha`) en vez de un preset o unos píxeles.\n * Consume `FotoPersonaService` (que acumula y cachea las peticiones); este\n * componente solo traduce tamaño → preset y decide qué pintar mientras carga\n * o cuando no hay foto real.\n */\n@Component({\n selector: 'jvs-foto-persona',\n standalone: true,\n templateUrl: './foto-persona.component.html',\n styles: [\n `\n :host {\n display: inline-block;\n line-height: 0;\n }\n\n img,\n .jvs-foto-persona__placeholder {\n display: block;\n }\n\n img {\n object-fit: cover;\n }\n\n .jvs-foto-persona__placeholder {\n background-color: #e5e7eb;\n }\n `,\n ],\n})\nexport class FotoPersonaComponent {\n private readonly fotoPersonaService = inject(FotoPersonaService);\n\n /**\n * Id de la persona. En `null` (por ejemplo, un formulario donde todavía no se eligió a\n * nadie) el componente **no pide nada al servicio**, pero sí pinta el estático genérico\n * `falta` en el tamaño que le toca a `tamano` — reserva el mismo hueco y evita un salto de\n * layout cuando se elige a alguien, en vez de dejar una caja vacía.\n */\n iPersId = input<number | null>(null);\n tamano = input<TamanoFoto>('tabla');\n alt = input<string>('Fotografía');\n clases = input<string>('');\n\n protected readonly preset = computed<Preset>(() => PRESET_POR_TAMANO[this.tamano()]);\n protected readonly dimension = computed<DimensionFoto>(() => DIMENSION_POR_TAMANO[this.tamano()]);\n\n /** Envuelve la signal que devuelve el servicio (que puede cambiar de instancia si cambia el preset). */\n private readonly foto = computed(() => this.fotoPersonaService.urlFoto(this.iPersId, this.preset())());\n\n /**\n * URL a pintar, o `null` mientras carga (todavía sin foto real ni\n * estático que mostrar). Prioridad: foto real → estático que indicó el\n * servidor → estático genérico `falta` cuando ni eso hay (falla de red\n * ya resuelta, o servidor que no devolvió nada).\n *\n * El estático de falta prefiere el asset local (`FotoPersonaService.rutaLocalDefecto()`) si\n * la app configuró `assetsBasePath` — las seis imágenes son chicas e idénticas para todas\n * las instalaciones, así que empaquetarlas evita una petición de red por instalación con\n * caché fría. Si la app no configuró esa ruta, cae al backend (`urlDefecto()`,\n * `GET /api/imagenes/default/{nombre}/{preset}.{ext}`), como siempre: ese es el comportamiento\n * sin cambios para quien todavía no copió los seis archivos.\n */\n protected readonly src = computed(() => {\n const resultado = this.foto();\n\n // `default` con valor significa que esta persona NO tiene foto propia, y se comprueba\n // ANTES que `url`: el manifiesto trae también la URL de la imagen genérica, así que si\n // se mirara `url` primero siempre ganaría la del servidor y el asset empaquetado no se\n // usaría jamás — que es justo lo que empaquetarlo venía a evitar.\n if (resultado.default) {\n return this.fotoPersonaService.rutaLocalDefecto(resultado.default)\n ?? resultado.url\n ?? this.fotoPersonaService.urlDefecto(resultado.default, this.preset());\n }\n\n if (resultado.url) {\n return resultado.url;\n }\n if (resultado.cargando) {\n return null;\n }\n\n // Ni foto ni respuesta del servidor (falla de red ya resuelta): último recurso genérico.\n return this.fotoPersonaService.rutaLocalDefecto('falta')\n ?? this.fotoPersonaService.urlDefecto('falta', this.preset());\n });\n}\n","@if (src(); as urlImagen) {\n <img\n [src]=\"urlImagen\"\n [alt]=\"alt()\"\n [width]=\"dimension().ancho\"\n [height]=\"dimension().alto\"\n [class]=\"clases()\"\n loading=\"lazy\"\n decoding=\"async\"\n />\n} @else {\n <div\n class=\"jvs-foto-persona__placeholder\"\n [class]=\"clases()\"\n [style.width.px]=\"dimension().ancho\"\n [style.height.px]=\"dimension().alto\"\n [attr.aria-label]=\"alt()\"\n ></div>\n}\n","/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './public-api';\n"],"names":[],"mappings":"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"}