createEntityAdapter: CRUD y selectores sin ceremonia

La lección anterior estableció por qué el estado compartido debe vivir normalizado; esta responde a la objeción inmediata: normalizar a mano es tedioso y propenso a errores. Cada colección repite la misma coreografía —insertar preservando el orden de ids, actualizar sin romper la inmutabilidad, borrar limpiando ambas mitades de la estructura, exponer los mismos cinco selectores— y esa repetición es justo el tipo de código donde los bugs se esconden. createEntityAdapter, incluido en Redux Toolkit, es la abstracción que captura ese patrón entero: le dices qué es tu entidad y te devuelve el estado inicial, los reducers CRUD y los selectores memoizados, todo coherente entre sí. Es, en esencia, la definición de una tabla con su índice y sus consultas, en una sola llamada.

El patrón repetido y su abstracción

Sin el adapter, cada slice de colección reescribe la misma lógica: comprobar si un id ya existe antes de añadirlo a ids, fusionar cambios parciales en una entidad existente, eliminar de entities y filtrar de ids al borrar. Es código correcto pero mecánico, y multiplicado por cada entidad de la app se convierte en superficie de bugs sin ningún valor de negocio. createEntityAdapter lo abstrae de una vez: recibe el tipo de entidad y opcionalmente cómo obtener su id y cómo ordenarla, y devuelve un objeto con métodos que producen exactamente esa lógica, ya probada.

Anatomía: initial state, CRUD y selectores

El adapter expone tres familias. getInitialState produce la forma vacía ids más entities, admitiendo campos extra para el estado que no sean entidades. Los reducers CRUD —que operan sobre el draft de Immer, así que puedes usarlos directamente dentro de createSlice— cubren todas las operaciones. Y getSelectors genera los selectores de lectura, re-basados sobre la rama del store donde vive la colección.

import { createEntityAdapter, createSlice } from '@reduxjs/toolkit'

interface Tarea { id: string; titulo: string; hecha: boolean; creada: number }

const adaptador = createEntityAdapter<Tarea>({
  selectId: (t) => t.id,                      // clave primaria (por defecto entity.id)
  sortComparer: (a, b) => b.creada - a.creada, // orden estable de ids
})

const slice = createSlice({
  name: 'tareas',
  initialState: adaptador.getInitialState({ cargando: false }), // campo extra
  reducers: {
    anadida: adaptador.addOne,
    sincronizadas: adaptador.upsertMany,
    editada: adaptador.updateOne,   // payload: { id, changes }
    borrada: adaptador.removeOne,
  },
})

// Selectores memoizados y re-basados sobre la rama del store.
export const {
  selectAll: selectTareas,
  selectById: selectTareaPorId,
  selectIds: selectIdsTareas,
  selectTotal: selectNumTareas,
} = adaptador.getSelectors((s: RootState) => s.tareas)

Identidad, orden y tipos

Dos opciones gobiernan el comportamiento. selectId indica cuál es la clave primaria cuando no se llama id —por ejemplo entity.uuid—. sortComparer mantiene el array ids ordenado en todo momento, de modo que selectAll y selectIds devuelven las entidades en ese orden sin que ningún componente tenga que ordenar; si lo omites, el orden es de inserción. El estado que produce el adapter tiene el tipo EntityState<Tarea, string>, con el tipo de la entidad y el tipo del id como parámetros, lo que te da autocompletado y comprobación en toda la cadena.

Integración y cuándo no usarlo

createEntityAdapter encaja con RTK Query: en el extraReducers de un slice puedes hacer adaptador.upsertMany cuando una query se cumple, normalizando en tu store la respuesta que RTK Query cachea por endpoint. Es el patrón estándar de 2026 para tener a la vez la caché de servidor de RTK Query y una colección normalizada de entidades consultable con selectores propios. Pero el adapter no es para todo: usarlo exige que tus datos sean entidades con id estable y que la colección justifique la maquinaria. Una lista fija de tres opciones de un menú, un estado que no es una colección, o datos sin identidad natural no ganan nada normalizándose; ahí el adapter añade ceremonia sin beneficio, y la lección siguiente te dará el criterio para no caer en ese exceso.