Bun – Habilidades do Terminal

Bun

Visão Geral

Bun é um runtime JavaScript/TypeScript all-in-one que substitui Node.js, npm, webpack e Jest com um único binário. Ele oferece suporte nativo a TypeScript, um servidor HTTP de alto desempenho (Bun.serve()), um gerenciador de pacotes rápido, um bundler e um executor de testes compatível com Jest com desempenho dramaticamente superior.

Instruções

• Ao criar servidores HTTP, use Bun.serve(), que lida com 100K+ req/s com suporte nativo a WebSocket, TLS e respostas em streaming.
• Ao gerenciar pacotes, use bun install (10-30x mais rápido que npm), bun add, bun remove e prefira bun.lock (formato texto) para diffs legíveis no git.
• Ao empacotar, use Bun.build() com o target apropriado ("browser", "bun", "node"), ative code splitting com splitting: true e configure tree shaking.
• Ao escrever testes, use bun test com API compatível com Jest (describe, it, expect), testes de snapshot, mocking com mock.module() e --coverage para cobertura de código.
• Ao fazer I/O de arquivos, prefira Bun.file() e Bun.write() ao invés de fs do Node.js para operações significativamente mais rápidas, e use Bun.Glob para correspondência de padrões.
• Ao lidar com autenticação, use Bun.password.hash() e Bun.password.verify() para bcrypt/argon2 em vez de pacotes npm.
• Ao migrar do Node.js, substitua node por bun nos scripts, mantenha package.json inalterado e observe que a maioria dos pacotes npm funciona sem modificações. Use bun:sqlite para bancos de dados embarcados em vez de pacotes SQLite npm.

Exemplos

Exemplo 1: Construir um servidor API de alto desempenho

Solicitação do usuário: "Crie uma API REST usando o servidor HTTP embutido do Bun"

Ações:

1. Crie o servidor com Bun.serve() e manipulador de rotas
2. Analise corpos JSON com request.json() e retorne objetos Response
3. Adicione upgrade WebSocket para funcionalidades em tempo real
4. Use Bun.password para autenticação e bun:sqlite para armazenamento de dados

Saída: Um servidor API rápido usando apenas os módulos nativos do Bun, sem dependências externas.

Exemplo 2: Migrar um projeto Node.js para Bun

Solicitação do usuário: "Troque meu projeto Express de Node.js para Bun"

Ações:

1. Substitua npm install por bun install no CI e na configuração local
2. Atualize scripts em package.json para usar bun run em vez de node
3. Substitua dotenv pelo carregamento embutido de .env do Bun
4. Troque o executor de testes de Jest para bun test com os mesmos arquivos de teste

Saída: Um projeto com Bun com instalação, inicialização e execução de testes mais rápidos.

Diretrizes

• Use Bun.serve() para novos servidores HTTP; é significativamente mais rápido que Express no Bun.
• Prefira Bun.file() e Bun.write() ao invés de fs do Node.js para operações de arquivos.
• Use bun:sqlite para dados locais em vez de adicionar pacotes SQLite npm.
• Use Bun.password para autenticação em vez de pacotes bcrypt/argon2 npm para zero dependências nativas.
• Mantenha bun.lock (formato texto) no git para diffs legíveis.
• Teste com bun test em vez de Jest para a mesma API com execução dramaticamente mais rápida.
• Ao segmentar navegadores, use Bun.build() com target: "browser".