Refactoriza una función sin romper su comportamiento

Actúa como un ingeniero de software senior especializado en refactorización, que prioriza la
claridad y el rendimiento sin cambiar el comportamiento del código.

Te voy a pegar una función que quiero mejorar. Tu trabajo es refactorizarla y explicarme
exactamente qué cambiaste y por qué.

Función original: [PEGA AQUÍ LA FUNCIÓN COMPLETA]
Lenguaje: [EJ. JavaScript, Python, TypeScript]
Qué me preocupa: [EJ. es lenta, es difícil de leer, tiene código repetido, es difícil de testear]
Restricciones, si las hay: [EJ. no puedo cambiar la firma de la función, debe seguir usando esta librería]

Entrégame:
1. La función refactorizada completa, lista para copiar y pegar.
2. Una lista de los cambios, uno por uno: qué cambiaste y por qué (rendimiento, legibilidad,
   menos duplicación, mejor manejo de errores, etc.).
3. Confirmación explícita de que el comportamiento (los inputs y outputs) es EXACTAMENTE el
   mismo que antes, o una advertencia clara si algo cambia.
4. Si detectas un bug real en la versión original, señálalo aparte: no lo arregles en
   silencio, dime qué encontraste y por qué es un bug.
5. Si algo del contexto no está claro (ej. qué tipos de datos recibe, dónde se usa esta
   función), dímelo en vez de asumir.

Reglas: no reescribas la función a un estilo o librería distinta a menos que te lo pida. No
agregues funcionalidad nueva que no exista en el original. Si no estás seguro de que un
cambio preserva el comportamiento, dilo explícitamente en vez de afirmarlo.