Fix: «productos.slice is not a function» al crear una plantilla de solicitud
Al abrir el formulario de una plantilla de solicitud (SOL-001) la pantalla reventaba:
Unhandled Runtime Error
TypeError: productos.slice is not a function
src\pages\plantillas-solicitud.tsx (383:32) @ slice
🔎 Causa raíz (dos capas)
1. El contrato del listado de productos cambió y este consumidor no.
GET /api/productos responde ahora con un sobre paginado:
{ "data": [ ... ], "meta": { "totalItems": 42, "totalPages": 3 } }
pages/products.tsx se actualizó en su día y hasta documenta el formato en un
comentario (// Format: { data: [...], meta: {...} }). plantillas-solicitud.tsx
se quedó esperando la forma antigua (un array pelado), así que guardaba el
sobre en el estado y productos.slice(...) no encontraba un array.
2. getAllProducts devuelve la respuesta de Axios, no el cuerpo. Es la única
función de src/api/product.ts que hace return response en lugar de
return response.data — 13 funciones hermanas devuelven el cuerpo — y contradice
su propio JSDoc («Paginated list of products»). Por eso el array no está en
respuesta.data, sino en respuesta.data.data.
Evidencia de que la forma es esa: widget-datos.ts ya tenía un ayudante propio
(aArreglo) que cava primero r.data.data, y getStockByCategory /
getGlobalStockFullness hacen lo mismo. Tres autores distintos resolviendo el
mismo sobre a mano.
🛠️ Corrección
Se centraliza la lectura en src/utils/respuesta-api.ts:
const cuerpo = respuesta?.data ?? respuesta;
if (Array.isArray(cuerpo)) return cuerpo;
if (Array.isArray(cuerpo?.data)) return cuerpo.data;
if (Array.isArray(cuerpo?.productos)) return cuerpo.productos;
// items / users / stockAlerts: claves de otros listados del sistema
return [];
extraerLista() garantiza siempre un array, así que ningún consumidor puede
volver a llamar a .map() o .slice() sobre un sobre. plantillas-solicitud.tsx
pasa a usarlo.
🧪 Verificación
Primero se reprodujo el fallo con una prueba que fallaba, escrita contra la lógica que tenía la pantalla:
✗ extrae el array del sobre paginado dentro de una respuesta de Axios
Received: {"data": [{"idProducto": 1}, ...], "meta": {"totalItems": 2}}
✗ nunca devuelve algo que no sea un array (el fallo original)
Expected: true Received: false
Es decir: devolvía el sobre, exactamente lo que hace reventar a .slice().
Tras el arreglo, src/utils/respuesta-api.spec.ts pasa 9/9.
npx tsc --noEmit -p tsconfig.json→ 0 errores.- Suite de la web: 241/252 pruebas, con los mismos 3 fallos previos (las suites de la migración TEC-019), sin regresiones nuevas.
✅ Corrección sistémica del contrato (misma entrega)
Se ha corregido el origen, no solo el síntoma:
getAllProductsdevuelveresponse.data(el cuerpo del API), como sus 13 funciones hermanas y como dice su JSDoc, que ahora avisa explícitamente de que no devuelve la respuesta de Axios.- Los 20 sitios que lo consumen quedaron migrados a
extraerLista()—o leyendo el sobre de forma explícita donde hacen falta metadatos—:
| Fichero | Qué requería |
|---|---|
pages/products.tsx (2 sitios) | Conservar meta.totalItems: era el único que usaba los metadatos y, sin ajustarlo, la paginación habría pasado a contar solo la página actual |
api/product.ts (2 sitios) | getStockByCategory conserva su throw para no pintar el gráfico con datos de relleno; getGlobalStockFullness usa el ayudante |
components/requests/mobile-request-detail.tsx | Además se corrigió que guardaba el sobre en el estado y que comprobaba officesResponse.success, campo inexistente en la respuesta de oficinas: las oficinas no se cargaban nunca |
components/tableros/widget-datos.ts | Su ayudante local aArreglo (duplicado del nuevo) se sustituyó por el compartido |
hooks/use-offline-inventory.ts | Cuidado especial: sin cuerpo no se toca la caché offline, porque cachear [] dejaría el modo offline marcado como «disponible» sin datos |
components/{inventory,lotes,reports,requests}/*, pages/{inventory-movements,pronostico-demanda,plantillas-solicitud} | Sustitución del desenvolvimiento a mano por el ayudante |
hooks/use-products.ts | Sin ningún consumidor (código muerto): se deja como está |
El contrato queda blindado con pruebas
src/api/product.spec.ts(nuevo): fija quegetAllProductsdevuelve el cuerpo y no unaAxiosResponse, y que devuelvenullsi la petición falla. Fallaba antes del cambio (Received: { config, data, headers }).src/utils/respuesta-api.spec.ts: 9 casos con todas las formas de respuesta que hay hoy en el sistema, incluidos los errores del API.
Verificación
npx tsc --noEmit -p tsconfig.json→ 0 errores (la comprobación central de los 20 sitios: cazó, por ejemplo, unlet x = []que quedaba inferido comonever[]al asignarle la lista).- Suite de la web: 246/257 pruebas, con los mismos 3 fallos previos (suites de la migración TEC-019), sin regresiones nuevas.
🧭 Lo que queda (fuera de esta entrega)
getAllProducts no era el único: otras 20 funciones de src/api/ devuelven
la respuesta de Axios en lugar del cuerpo — request.ts (9), aprobaciones.ts
(4), inventory-movement.ts (3), presupuestos.ts (3) y log.ts (2), de un total
de 365 exports. Por eso siguen existiendo consumidores que cavan .data.data a mano
(logs-table.tsx, inventory-summary.tsx con los movimientos,
mobile-requests.tsx…). Consolidar esos módulos con el mismo criterio es el
siguiente paso natural, y ya tiene el ayudante y las pruebas que necesita.
🐛 Hallazgo aparte: el logger revienta en el navegador
Al escribir las pruebas apareció que src/config/logger-dev.ts usa el transporte de
pino, que necesita APIs de Node. En jsdom el catch de getAllProducts no
devuelve null, sino que revienta con:
ReferenceError: setImmediate is not defined
setImmediate tampoco existe en el navegador, así que el efecto probable es que
muchos catch que solo registran el error y devuelven un valor de relleno no
lleguen a hacerlo, y que el error original quede enmascarado por un
ReferenceError. No se toca en esta entrega: merece su propio diagnóstico.
