Usar Bun en tu flujo de trabajo (Experimental)

¿Te ha pasado que esperar a que el entorno de desarrollo responda te saca de ritmo? Quieres esa velocidad extra al ejecutar tests o instalar dependencias, pero te preocupa romper la estabilidad del proyecto o crear conflictos con el resto de tu equipo.

Bun es una opción para acelerar tu flujo local, aunque debes tener cuidado. Mi recomendación es clara: usa Bun para desarrollo, pero mantén Node.js en producción para evitar fallos inesperados.

Requisitos previos

• Bun (para ejecución local de TypeScript).
• pnpm (para builds y herramientas de documentación).

Inicio rápido

El objetivo es usar Bun sin abandonar el flujo de trabajo de pnpm. Ten en cuenta que no recomiendo Bun para el runtime de Gateway (WhatsApp/Telegram) debido a bugs detectados. Usa Node.js para entornos de producción.

1. Instala dependencias: Ejecuta bun install. Si prefieres que Bun no genere archivos nuevos, usa bun install --no-save.
2. Compila el proyecto: Usa el comando bun run build.
3. Ejecuta los tests: Utiliza bun run vitest run para verificar tu código.
4. Scripts específicos: Algunos scripts como docs:build o ui:* tienen pnpm hardcoded, así que ejecútalos con pnpm.

Solución de problemas

Scripts de ciclo de vida bloqueados

Bun bloquea por defecto los scripts de ciclo de vida de las dependencias. En este repositorio, scripts como los de @whiskeysockets/baileys (que verifica la versión de Node) o protobufjs no suelen ser necesarios. Si encuentras un problema real en el runtime que requiera estos scripts, dales permiso explícito:

bun pm trust @whiskeysockets/baileys protobufjs

Conflictos de lockfile

Bun no puede usar el archivo pnpm-lock.yaml y lo ignorará por completo. Como bun.lockb está en el .gitignore, no causarás ruido en el repositorio al usar Bun localmente.

¿Necesitas ayuda con la configuración? Prueba el AI Setup Assistant.

Próximos pasos

• Configuración de Node.js
• Guía de despliegue en producción