Migración desde v1
v2 es una reescritura completa de webserial-core y no es compatible con v1.
La versión 2 introduce una nueva arquitectura, un nuevo sistema de adaptadores, nueva estructura de carpetas, nuevo formato de salida de compilación y cambios en toda la API pública. No existe una ruta de actualización incremental.
Enfoque recomendado
La forma más limpia de migrar es empezar desde cero con v2:
Desinstala v1 e instala v2:
bashnpm remove webserial-core npm install webserial-core@latestElimina cualquier extensión existente de la antigua clase
SerialDevice.Crea una nueva clase que extienda
AbstractSerialDevice<T>siguiendo la guía de Primeros pasos.
¿Por qué una reescritura completa?
La versión 1 fue un prototipo que demostró el concepto. La versión 2 fue diseñada desde cero con los siguientes objetivos que requirieron cambios incompatibles en cada capa:
- TypeScript estricto — sin
any, JSDoc completo, interfaces con nombre para cada opción - Sistema de adaptadores modular — WebUSB, Web Bluetooth y WebSocket son transportes de primera clase
- Salida dual ESM + CJS — compilación correcta con
.mjs/.cjs/.umd.jsvía Vite - Responsabilidades aisladas — parsers, cola, eventos, registro y adaptadores son módulos separados que pueden testearse independientemente
- Código fuente solo en inglés — todo el código fuente, JSDoc y mensajes de error están en inglés
Referencia
Empieza aquí
Lee la guía de Primeros pasos para la API completa de v2.